Ir para o conteúdo

Testador de .htaccess

Descubra por que uma regra RewriteRule/RewriteCond não bate, por que a URL amigável parou de funcionar ou por que um redirect quebrou: cole as regras do Apache mod_rewrite e uma URL de teste e veja o veredito por regra, os grupos capturados e a URL final — sem nunca gerar configuração.

Privacidade e escopo: tudo roda no seu navegador — a única execução de regex (derivada das suas regras) acontece em um Web Worker isolado, com timeout de 1 segundo, a mesma proteção contra ReDoS do Testador de Regex. Esta ferramenta só testa e explica — nunca gera um arquivo .htaccess.

Escopo suportado (leia antes de testar): diretivas RewriteEngine, RewriteRule e RewriteCond; flags [L], [R=301], [R=302], [NC], [QSA], [END] ; variáveis de RewriteCond%{REQUEST_URI}, %{HTTP_HOST}, %{QUERY_STRING} . Fora do escopo (sinalizado, nunca processado silenciosamente): RewriteMap, outras variáveis de servidor, mod_alias, autenticação, diretivas nginx e a flag [OR] de RewriteCond.

Testar regras

Cole regras RewriteRule/RewriteCond e uma URL de teste para começar.

O que é .htaccess e mod_rewrite

Um arquivo .htaccess é um arquivo de configuração por diretório do servidor web Apache, usado para sobrescrever configurações sem acesso ao arquivo principal do servidor. O módulo mod_rewrite, dentro dele, permite reescrever URLs — transformar /produto/123 em uma consulta interna, redirecionar URLs antigas para novas, forçar HTTPS, entre outros usos. As regras são escritas com as diretivas RewriteRule e RewriteCond, avaliadas em sequência, de cima para baixo.

RewriteRule vs. RewriteCond

RewriteRule Pattern Substitution [flags] define o padrão a testar contra a URL e o que colocar no lugar quando casa. RewriteCond TestString CondPattern [flags], colocada imediatamente antes de uma RewriteRule, adiciona uma condição extra: sem RewriteCond, a regra vale sempre que seu próprio padrão casar; com uma ou mais RewriteCond, todas elas precisam casar também (avaliação em "E") para a regra ser aplicada.

As flags suportadas por esta ferramenta

[L] interrompe a cadeia de regras assim que uma casa. [R=301] e [R=302] transformam a reescrita em um redirecionamento HTTP real enviado ao navegador (permanente ou temporário). [NC] ignora maiúsculas/minúsculas no padrão. [QSA] preserva a query string original, anexando-a à URL resultante. [END] tem efeito equivalente a [L] nesta simulação. Qualquer outra flag colada no campo é sinalizada como não suportada, nunca aplicada silenciosamente.

Ordem de avaliação e falhas comuns

A maioria dos problemas de .htaccess não está na sintaxe de uma regra isolada. Está em como o Apache decide, regra a regra, o que aplicar e o que ignorar. Os cinco sintomas abaixo cobrem os motivos mais comuns de uma regra rewrite se comportar diferente do esperado.

Por que minha RewriteRule não funciona

A causa mais comum é o contexto do padrão. Dentro do .htaccess, o Apache testa a RewriteRule contra o caminho relativo ao diretório — não contra a URL completa com domínio e query string. Um padrão escrito para https://exemplo.com/blog/post-1 raramente casa se o Apache está comparando só blog/post-1. Outra causa frequente: uma RewriteCond antes da regra não é satisfeita, e o padrão da RewriteRule nem chega a ser avaliado.

Verificação: cole a regra isolada aqui e teste com a URL completa e depois só com o caminho. Se uma casa e a outra não, o padrão foi escrito para o contexto errado. Havendo RewriteCond antes, confira o veredito de cada condição — o resultado aponta qual delas barrou a regra antes do padrão ser avaliado.

Ordem das regras no .htaccess muda o resultado

Costuma aparecer depois de uma migração de CMS ou da adição de uma regra nova no topo do arquivo. O Apache para de avaliar assim que uma regra com [L] casa. Uma regra recém-adicionada pode assim capturar a requisição antes que a regra antiga — a que fazia a URL amigável funcionar — seja alcançada.

Verificação: cole todas as regras juntas, não só a que você suspeita, e teste a URL que parou de funcionar. O veredito por regra mostra qual delas capturou a requisição primeiro e por que as regras seguintes nem chegaram a rodar.

Redirect 301 no Apache não funciona

O motivo mais comum é confusão entre reescrita interna e redirecionamento real. Sem [R=301] ou [R=302], a RewriteRule só reescreve a URL por dentro do servidor — o navegador nunca vê outro endereço. Isso é o comportamento esperado numa reescrita interna, mas não ajuda quando a intenção era mandar o visitante para outro domínio ou caminho. Um loop de redirecionamento é outra causa comum: uma regra com [R] cuja substituição volta a casar com o próprio padrão.

Verificação: teste a URL de origem aqui e confira o campo "URL resultante" e o selo de status HTTP. Se não aparecer HTTP 301 nem 302, é sinal de que o .htaccess não está redirecionando por falta da flag. Se a URL resultante for igual à de entrada, há loop.

Por que o .htaccess não funciona mesmo com regras aparentemente certas

Quando nenhuma regra parece fazer diferença, a causa raramente está nas regras em si. O motivo mais comum é RewriteEngine ausente ou desligado: sem RewriteEngine on, nenhuma RewriteRule roda, mesmo que esteja sintaticamente correta. Outro motivo frequente é AllowOverride None no VirtualHost, que impede o Apache de sequer ler o arquivo do diretório.

Verificação: esta ferramenta sinaliza quando falta RewriteEngine on nas regras coladas. Se esse alerta não aparecer aqui, mas o .htaccess não funciona do mesmo jeito em produção, o problema está fora do arquivo. Pode ser AllowOverride ou um módulo mod_rewrite desativado no servidor — algo que esta ferramenta não enxerga.

Erro 500 no .htaccess

Erro 500 depois de mexer no .htaccess quase sempre é loop de redirecionamento. Dentro de uma única passada, uma regra sem [L] só segue para a próxima regra, que já recebe a URL modificada. Não há reinício aqui — é isso que o veredito por regra mostra. Mas em contexto .htaccess, toda vez que uma regra muda a URL, o Apache reprocessa a requisição do zero, reaplicando o arquivo inteiro desde o topo. [L] encerra a passada atual, mas não impede esse reprocessamento — só [END] impede. Se a substituição voltar a casar com o próprio padrão, isso vira um loop até o limite interno de redirecionamento do Apache, que devolve HTTP 500.

Verificação: esta ferramenta simula uma única passada pelo arquivo, então não mostra o reprocessamento entre passadas nem reproduz o loop em si. O que ela mostra é a URL resultante de cada regra depois dessa passada. Se a URL resultante voltar a casar com o padrão de uma regra anterior, é sinal forte de loop. A confirmação final só vem testando as regras em produção ou nos logs do Apache.

Por que esta ferramenta não gera um .htaccess

Gerar um arquivo de configuração de servidor sem visibilidade real do ambiente — versão do Apache, módulos habilitados, outras regras já presentes no VirtualHost — produz um resultado plausível-mas-arriscado de colar em produção. Por isso esta ferramenta testa e explica regras que você já escreveu, em vez de tentar adivinhar a configuração ideal para o seu servidor.

Depois de confirmar que suas regras de redirecionamento fazem sentido, o Testador e Gerador de robots.txt ajuda a garantir que o Google continue rastreando as URLs corretas após a mudança.

Perguntas frequentes