blog
Infraestrutura web

404 nas internas após migrar para LiteSpeed: 3 provas

Três provas em ordem para separar regra de reescrita ignorada de arquivo que realmente não existe, com checklist de verificação em lote e uma frase pronta para o cliente.

JR · · 9 min de leitura · 1 tabela · 7 blocos de código

Resposta curta: nesse sintoma, a primeira hipótese a eliminar é o `.htaccess` deixar de ser lido pelo servidor novo, não o WordPress. A home abre porque não depende de reescrita; as internas dependem.

Neste artigo
  1. O que muda no roteamento quando o servidor web troca de Apache para LiteSpeed
  2. Prova 1, quebrar o `.htaccess` de propósito para saber se ele é lido
  3. Prova 2, descobrir onde o servidor procura o arquivo e o que ele considera índice
  4. Prova 3, separar no log o 404 da regra não aplicada do 404 do WordPress
  5. O bloco padrão do WordPress e por que não colar o `.htaccess` antigo inteiro
  6. Checklist para verificar a carteira inteira em lote e abrir um chamado só
  7. O que dizer ao cliente que acha que o site foi invadido

Home abre, /sobre devolve 404, o WordPress continua lá. Esse sintoma, logo depois de o servidor passar de Apache para LiteSpeed, tem como primeira hipótese a eliminar a regra de reescrita que deixou de ser aplicada, não conteúdo perdido. A home funciona porque ela é servida pelo índice do diretório e não depende de RewriteRule. Qualquer URL amigável depende.

O roteiro abaixo é o que você roda antes de mexer em plugin, banco ou backup. São três provas, nessa ordem, porque cada uma elimina uma causa inteira.

O que muda no roteamento quando o servidor web troca de Apache para LiteSpeed

O LiteSpeed Web Server lê .htaccess com sintaxe compatível com Apache, mas a leitura depende de o arquivo estar habilitado na configuração do servidor e do vhost. A documentação do LiteSpeed para cPanel lista justamente esse cenário entre as causas de erro 404: a diretiva de reescrita não estar sendo lida, o arquivo de índice do diretório não estar configurado, ou o DocumentRoot apontar para outro lugar (LiteSpeed on cPanel: 404 error).

Traduzindo para o seu dia a dia: o WordPress gera links como https://cliente.com.br/servicos/. Não existe pasta servicos no disco. O .htaccess é que manda o servidor entregar index.php quando o caminho não existe fisicamente. Sem essa regra ativa, o servidor procura um arquivo real, não acha, devolve 404. É o comportamento correto do servidor diante de uma configuração incompleta.

Sintoma Causa provável Prova que confirma
Home abre, todas as internas 404 .htaccess ignorado Prova 1 (linha inválida)
Site inteiro 404, inclusive home índice do diretório ou DocumentRoot Prova 2
Uma página só dá 404 conteúdo, slug ou cache Prova 3 (log)
404 só em /wp-admin ou em uma pasta regra herdada de subdiretório Prova 1 na pasta filha
Ordem de diagnóstico do 404 nas internasProva 1: .htaccess é lido?Linha inválida deve gerar 500Sem 500: testar Redirect 302Não redirecionou, arquivo ignoradoDeu 500: ir para Prova 2Checar índice e DocumentRootProva 3: ler o logFile does not exist ou index.phpCaminho físico no logReescrita não aplicada, revisar blocoCaminho com index.php404 veio do WordPress
Ordem das provas: cada uma elimina uma causa inteira antes de mexer em plugin, banco ou backup.

Prova 1, quebrar o `.htaccess` de propósito para saber se ele é lido

Não basta o arquivo existir. Ele precisa estar habilitado. O teste mais rápido é propositalmente quebrar o arquivo e ver se o servidor reclama.

A linha inválida que deve derrubar o site, e o redirect que confirma o falso negativo

Abra o .htaccess da raiz do site e coloque, na primeira linha, uma diretiva que não existe:

TesteDeLeituraDoArquivo on

Salve e recarregue qualquer URL do site.

Nem todo servidor responde 500 a uma diretiva desconhecida. Dependendo da configuração, ele registra a linha no log de erro e serve a página normalmente, o que produz falso negativo. O resultado esperado do teste é 500 ou um erro de configuração visível no log. Se nada mudou, confirme com um segundo sinal antes de concluir: coloque no lugar da linha inválida uma diretiva válida de efeito visível, por exemplo

Redirect 302 /teste-htaccess /?htaccess=ok

Recarregue https://exemplo-do-cliente.com.br/teste-htaccess. Se redirecionar, o arquivo está sendo lido e a causa do 404 é outra. Se devolver 404, aí sim o .htaccess não está sendo aplicado nesse diretório.

Remova a linha de teste logo depois, seja a inválida ou o redirect. Não deixe para depois: se o arquivo é lido, o site fica fora do ar enquanto a diretiva inválida estiver lá. Faça em horário de baixo tráfego e com a linha já copiada para apagar.

Por que `AllowOverride None` ignora o arquivo em silêncio, e o que pedir no chamado

Em Apache, a leitura do .htaccess depende de AllowOverride no bloco do diretório. Com AllowOverride None, o arquivo é ignorado em silêncio. Em instalações com LiteSpeed sob painel, a documentação orienta verificar se o .htaccess está habilitado na configuração do servidor e se o contexto do vhost permite a sobrescrita (LiteSpeed on cPanel: 404 error).

No WebAdmin do LiteSpeed, isso aparece em duas camadas: a configuração do servidor (onde o uso de .htaccess é habilitado globalmente) e o virtual host (onde se define o nível de sobrescrita permitido). Em hospedagem compartilhada você não tem esse painel; o caminho é abrir chamado pedindo exatamente isto, com o resultado da Prova 1 em anexo: "o .htaccess da raiz não produz 500 com diretiva inválida nem aplica um Redirect 302 de teste, favor verificar se a leitura de .htaccess está habilitada para este vhost". Esse texto economiza duas idas e voltas.

Prova 2, descobrir onde o servidor procura o arquivo e o que ele considera índice

Se a Prova 1 deu 500, o arquivo é lido. Resta checar onde o servidor está procurando e o que ele considera índice.

Quando a lista de índice fica só com `index.html`

O servidor precisa saber que index.php é um índice válido. Em configurações migradas às pressas, a lista de arquivos de índice às vezes fica só com index.html. O resultado é home em branco ou 404 em diretórios. A documentação do LiteSpeed cita a configuração do arquivo de índice entre os itens a conferir em erro 404.

Você pode forçar a lista no próprio .htaccess, o que resolve sem depender do painel:

DirectoryIndex index.php index.html

Como testar o `DocumentRoot` sem acesso ao painel

Se o site foi movido de pasta durante a migração, o vhost pode continuar apontando para o caminho antigo. Um jeito rápido de ver de onde o servidor está servindo, sem acesso ao painel, é criar um arquivo temporário na pasta que você acha que é a raiz:

echo "raiz-correta" > ~/public_html/teste-raiz.txt
curl -s https://exemplo-do-cliente.com.br/teste-raiz.txt

Se voltar raiz-correta, o DocumentRoot é esse. Se voltar 404, o servidor está servindo outra pasta. Apague o arquivo depois. O domínio acima é exemplo; troque pelo do cliente.

Prova 3, separar no log o 404 da regra não aplicada do 404 do WordPress

O log distingue duas coisas que, no navegador, parecem idênticas: regra que não foi aplicada e arquivo que realmente não existe. Esta prova só faz sentido depois de a Prova 1 ter devolvido 500 ou aplicado o redirect de teste, ou seja, com o .htaccess comprovadamente sendo lido.

Em hospedagem com cPanel, o caminho varia conforme o servidor. Os três lugares a conferir: a seção Errors do painel, o arquivo ~/logs/<dominio>.error_log (em instalações que separam log por domínio) e o error_log gravado pelo PHP na raiz do site ou na pasta onde o erro ocorreu. O diretório ~/logs costuma guardar principalmente logs de acesso, então não assuma que o arquivo de erro está lá.

Para saber qual arquivo é o seu, liste os candidatos por data de modificação, recarregue a URL com problema e liste de novo. O que cresceu é o log certo:

ls -lt ~/logs/ ~/public_html/error_log 2>/dev/null | head -n 20
tail -f ~/logs/*.error_log ~/public_html/error_log 2>/dev/null

O que procurar:

Se o log estiver vazio enquanto você recarrega a página, provavelmente você está olhando o log errado ou a resposta está vindo de cache. Force com um parâmetro: https://exemplo-do-cliente.com.br/servicos/?nocache=1.

O bloco padrão do WordPress e por que não colar o `.htaccess` antigo inteiro

Quando o arquivo foi perdido na migração, o caminho mais seguro é regravá-lo pelo próprio WordPress: Configurações > Links permanentes > Salvar alterações. Isso reescreve o bloco padrão sem você digitar nada.

Se precisar colar manualmente, use só o bloco do núcleo e nada mais, num primeiro momento:

# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress

O erro comum em migração é colar de volta o arquivo inteiro do servidor antigo, com blocos de cache, de segurança e de módulos que podem não existir no novo ambiente. Restaure o núcleo primeiro, confirme que as internas abrem, e só então devolva os blocos extras um a um, testando a cada um. Se o site está em subdiretório, o RewriteBase muda para o caminho do subdiretório.

Checklist para verificar a carteira inteira em lote e abrir um chamado só

Quando o provedor migra todos os seus sites de uma vez, o ganho está em verificar em lote e só abrir os casos que falharem.

  1. Monte um arquivo dominios.txt, um domínio por linha.
  2. Teste uma URL interna conhecida de cada site e registre o código HTTP:
while read d; do
  echo -n "$d "
  curl -s -o /dev/null -w "%{http_code}\n" "https://$d/sitemap.xml"
done < dominios.txt
  1. Separe os que voltarem 404. Esses entram na fila de diagnóstico.
  2. Para cada um, rode a Prova 1 (linha inválida, verificar se vira 500 e, se não virar, testar o Redirect 302; remover a linha em seguida).
  3. Agrupe por resultado. Se vários sites do mesmo servidor falham nos dois sinais, é configuração de servidor, não dos sites: abra um chamado citando todos os domínios.
  4. Nos que produzirem 500 ou aplicarem o redirect, regrave os permalinks e confirme a URL interna de novo.
  5. Depois de corrigir, limpe o cache do LiteSpeed e o CDN de cada site antes de dar por encerrado.
  6. Registre no seu controle qual site tinha bloco extra no .htaccess, porque esse é o que vai quebrar de novo na próxima migração.

Troque sitemap.xml por uma URL que exista em todos os sites. O importante é não usar a home, que é exatamente a página que funciona mesmo com o problema.

Verificação em lote da carteira de sitesListar domíniosUm por linha em dominios.txtTestar URL internacurl registra o código HTTPRodar Prova 1 nos 404Linha inválida e redirectAgrupar por resultadoMesmo servidor, um chamado sóRegravar e limpar cachePermalinks, LiteSpeed e CDN
Fluxo de verificação em lote da carteira depois de uma migração de servidor.

O que dizer ao cliente que acha que o site foi invadido

O cliente vê páginas sumindo e pensa em invasão. Antecipe a conversa.

Frase pronta, por mensagem ou e-mail:

Duas coisas que ajudam a sustentar isso: se o cliente tiver acesso ao painel do WordPress, as páginas continuam listadas lá, e você pode pedir que ele confirme. E se houver Search Console, avise que os 404 vão aparecer no relatório e que tendem a sair após novos rastreios, em prazo que o Google não garante; se houver urgência em alguma página, use a Inspeção de URL para solicitar reindexação das principais.

O que não dizer: "está com o provedor". Mesmo quando é verdade, o cliente contratou você. Diga o que já foi identificado, o que depende de terceiro e qual o prazo que você está cobrando.

Referências

  1. Documentação oficial (litespeed) — LiteSpeed on cPanel: 404 error. Consultado em 2026-10-08.
Leia também