# 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.

> 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.

João Rizzon · 2026-11-07 · Infraestrutura web

---

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](https://docs.litespeedtech.com/lsws/cp/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:

```apache
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 `.htaccess` provavelmente 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

```apache
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](https://docs.litespeedtech.com/lsws/cp/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:

```apache
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:

```bash
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:

```bash
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 `.htaccess` e o valor de `RewriteBase`, 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:

```apache
# 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:

```bash
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:

> **** "O conteúdo do site está inteiro e não houve invasão. O servidor do seu site foi atualizado e, nessa troca, a regra que traduz os endereços das páginas internas deixou de ser aplicada. Por isso a página inicial abre e as internas dão erro 404. Já identifiquei a causa e estou aplicando a correção; nenhum texto, imagem ou página precisa ser refeito."

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.

