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.

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
- O que muda no roteamento quando o servidor web troca de Apache para LiteSpeed
- Prova 1, quebrar o `.htaccess` de propósito para saber se ele é lido
- Prova 2, descobrir onde o servidor procura o arquivo e o que ele considera índice
- Prova 3, separar no log o 404 da regra não aplicada do 404 do WordPress
- O bloco padrão do WordPress e por que não colar o `.htaccess` antigo inteiro
- Checklist para verificar a carteira inteira em lote e abrir um chamado só
- 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 |
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.
- Se o site passar a devolver 500 Internal Server Error, o arquivo está sendo lido. A causa do 404 é outra: siga para a Prova 2 ou 3.
- Se o site continuar exatamente igual (home abre, interna 404), o
.htaccessprovavelmente não está sendo lido, mas não conclua ainda.
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:
- Mensagem de File does not exist apontando para um caminho físico como
/home/usuario/public_html/servicos: o servidor tentou servir uma pasta real. A reescrita não foi aplicada, mesmo com o arquivo sendo lido. Revise o bloco do núcleo do WordPress no.htaccesse o valor deRewriteBase, e confira se algum bloco anterior interrompe o fluxo antes dele. - Mensagem apontando para um caminho que termina em
index.php: a reescrita aconteceu e o 404 veio do WordPress. Aí sim o problema é permalink, conteúdo ou plugin. - Erro de sintaxe citando a linha do
.htaccess: alguma diretiva do arquivo não é suportada no contexto atual. Comente a linha citada e teste.
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.
- Monte um arquivo
dominios.txt, um domínio por linha. - 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
- Separe os que voltarem
404. Esses entram na fila de diagnóstico. - 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). - 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.
- Nos que produzirem 500 ou aplicarem o redirect, regrave os permalinks e confirme a URL interna de novo.
- Depois de corrigir, limpe o cache do LiteSpeed e o CDN de cada site antes de dar por encerrado.
- 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.
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
- Documentação oficial (litespeed) — LiteSpeed on cPanel: 404 error. Consultado em 2026-10-08.