Snippets

Domine a Remoção de Query Strings para Superar o Cache de Recursos Estáticos

Por bernardocollet • 2 de fevereiro de 2026 • 7 min de leitura

Desvendando a Otimização: Remover o Query String de Recursos Estáticos

Você já se perguntou por que seu site não carrega tão rápido quanto poderia, mesmo após otimizar imagens e scripts? Um culpado comum e muitas vezes negligenciado são os query strings em recursos estáticos. Estes pequenos fragmentos de texto, como ?ver=1.0 ou ?v=abcdef, anexados aos URLs de CSS e JavaScript, podem sabotar seus esforços de caching e impactar negativamente o desempenho do seu site. Neste guia completo, nós vamos explorar o problema e, mais importante, oferecer snippets práticos para remover o query string de recursos estáticos, garantindo que seus visitantes desfrutem de uma experiência de navegação ágil e sem interrupções.

A remoção desses parâmetros é uma etapa crucial para qualquer estratégia de otimização de velocidade. Afinal, um site mais rápido não apenas melhora a experiência do usuário, mas também contribui significativamente para um melhor ranqueamento nos motores de busca. Portanto, prepare-se para transformar a performance do seu site.

Por Que Remover Query Strings de Recursos Estáticos?

Muitos desenvolvedores utilizam query strings para forçar o navegador a carregar uma nova versão de um arquivo, essencialmente ‘quebrando o cache’. Embora esta prática tenha sua utilidade, ela geralmente é mal interpretada ou aplicada de forma excessiva. Na realidade, a maioria dos servidores proxy e CDNs (Content Delivery Networks) não armazenam em cache URLs com query strings. Isso significa que, mesmo que você tenha configurado corretamente os cabeçalhos de cache, o navegador do usuário pode não estar aproveitando o cache local para esses recursos.

Consequentemente, cada vez que um usuário visita seu site, ou navega para uma nova página, ele pode estar baixando repetidamente arquivos que deveriam estar em cache. Isso não apenas aumenta o tempo de carregamento da página, mas também consome mais largura de banda do servidor. Além disso, ferramentas como o Google PageSpeed Insights frequentemente sinalizam a presença de query strings como uma oportunidade de otimização, pois elas impedem o aproveitamento máximo do cache do navegador.

Melhora do Cache do Navegador: Permite que os navegadores armazenem em cache seus arquivos CSS e JavaScript de forma mais eficaz.
Otimização de CDNs: Garante que as CDNs possam servir seus arquivos em cache, reduzindo a latência e a carga do servidor de origem.
Pontuação no PageSpeed Insights: Contribui para uma melhor pontuação nas ferramentas de auditoria de desempenho.
Redução da Carga do Servidor: Menos solicitações de arquivos já em cache significam menos trabalho para o seu servidor.

Remover Query String de Recursos Estáticos no WordPress

Para sites WordPress, a remoção de query strings é uma tarefa relativamente simples que pode ser realizada adicionando um snippet de código ao arquivo functions.php do seu tema filho. É crucial usar um tema filho para evitar que suas modificações sejam sobrescritas em futuras atualizações do tema principal. Esta abordagem é eficaz e não requer plugins adicionais.

Adicione o seguinte código ao seu functions.php:

function _remove_query_strings_split( $src ){
    $output = preg_split( "/[?#]/", $src );
    return $output[0];
}
function remove_css_js_query_strings( $src ) {
    if( strpos( $src, '?' ) ) {
        $src = remove_query_arg( 'ver', $src );
        $src = remove_query_arg( 'v', $src );
    }
    return _remove_query_strings_split( $src );
}
add_filter( 'script_loader_src', 'remove_css_js_query_strings', 15, 1 );
add_filter( 'style_loader_src', 'remove_css_js_query_strings', 15, 1 );

Este snippet remove os parâmetros ver e v de todos os scripts e estilos enfileirados pelo WordPress. Ele garante que os URLs fiquem limpos, favorecendo o cache. Após implementar esta modificação, é aconselhável limpar o cache do seu site e do navegador para ver os resultados imediatamente. Verifique o código-fonte da página para confirmar que as query strings foram removidas.

Configurando Servidores: Apache e Nginx para Limpeza de URLs

Se você não utiliza WordPress ou prefere uma abordagem a nível de servidor, pode configurar o Apache ou Nginx para reescrever os URLs e remover o query string de recursos estáticos. Esta é uma solução poderosa que afeta todos os recursos servidos pelo servidor, independentemente da plataforma.

Apache (.htaccess)

Para servidores Apache, você pode adicionar regras de reescrita ao seu arquivo .htaccess. Certifique-se de que o módulo mod_rewrite esteja habilitado em seu servidor. Insira o seguinte código no topo do seu .htaccess:

<IfModule mod_rewrite.c>
  RewriteEngine On
  RewriteCond %{QUERY_STRING} !^$
  RewriteCond %{REQUEST_URI} .(css|js|gif|png|jpg|jpeg|svg|webp|woff|woff2|ttf|eot)(?.*)?$ [NC]
  RewriteRule ^(.*)$ /$1? [L,R=301]
</IfModule>

Esta regra verifica se o URL contém uma query string e se o recurso é um arquivo estático comum (CSS, JS, imagens, fontes). Se ambas as condições forem verdadeiras, ele reescreve o URL, removendo a query string e emitindo um redirecionamento 301. O redirecionamento 301 é importante para informar aos motores de busca e navegadores a nova localização permanente do recurso. Lembre-se de testar cuidadosamente após aplicar estas regras.

Nginx (nginx.conf)

Para usuários Nginx, a configuração é feita no arquivo nginx.conf ou em um arquivo de configuração de site específico (geralmente em /etc/nginx/sites-available/yourdomain.com). Adicione o bloco location abaixo dentro do seu bloco server:

location ~* .(js|css|png|jpg|jpeg|gif|svg|webp|woff|woff2|ttf|eot)$ {
    if ($query_string) {
        return 301 $uri;
    }
    expires max;
    add_header Pragma public;
    add_header Cache-Control "public, immutable";
}

Este bloco de configuração Nginx é mais direto. Ele verifica se há uma query string presente para os tipos de arquivos especificados. Se encontrar uma, ele retorna um redirecionamento 301 para o URI sem a query string. Além disso, ele define cabeçalhos de expiração e cache para garantir que os recursos sejam armazenados em cache pelo máximo de tempo possível. Lembre-se de reiniciar o Nginx após fazer as alterações para que elas entrem em vigor.

Considerações Importantes e Estratégias de Versionamento

Ao remover o query string de recursos estáticos, você otimiza o cache, mas também precisa de uma estratégia para invalidar o cache quando atualiza seus arquivos. Sem query strings, os navegadores podem continuar a servir versões antigas dos arquivos em cache. A solução mais comum e eficaz é o file versioning ou cache busting através de nomes de arquivos.

Renomear o Arquivo: A maneira mais simples é adicionar um hash ou uma versão ao nome do arquivo (ex: style.1a2b3c.css ou script.v2.js). Quando o arquivo muda, seu nome também muda, forçando o navegador a baixar a nova versão. Ferramentas de build como Webpack ou Gulp automatizam este processo.
Plugins de Cache: Muitos plugins de cache para WordPress oferecem funcionalidades para lidar com a invalidação de cache de forma inteligente, reescrevendo URLs para incluir hashes de versão.
CDNs Inteligentes: Algumas CDNs possuem mecanismos para invalidar o cache de forma programática ou através de regras específicas, mesmo sem query strings.

Adotar uma estratégia de versionamento garante que suas otimizações de cache não comprometam a entrega de conteúdo atualizado. É um equilíbrio entre performance e atualização.

Conclusão: Velocidade e Eficiência para Seu Site

A otimização da velocidade do site é um processo contínuo, e remover o query string de recursos estáticos é uma etapa fundamental que não deve ser ignorada. Ao implementar os snippets e as configurações de servidor que discutimos, você não apenas melhorará a pontuação do seu site em ferramentas de desempenho, mas, mais importante, proporcionará uma experiência de usuário superior. Um site mais rápido significa visitantes mais felizes, taxas de conversão mais altas e melhor visibilidade nos motores de busca.

Não deixe que pequenos detalhes como query strings atrapalhem o potencial do seu site. Tome as rédeas da otimização e comece a ver resultados tangíveis hoje mesmo. Implemente essas mudanças, monitore o desempenho do seu site e continue a aprimorar sua presença online. A velocidade compensa!