# Erro do LiteSpeed ou do site: teste de 10 minutos

O teste de isolamento que a agência faz antes de cobrar hora de debug, com o que quebra durante a janela e como voltar sem resíduo.

> Você separa as duas famílias de causa em 10 minutos: troque o servidor web de LiteSpeed para Apache no WHM e reproduza o erro nas duas configurações. Se o erro some no Apache, a causa está na camada do servidor web; se persiste igual, está no código, plugin ou PHP da conta.

João Rizzon · 2026-10-04 · Infraestrutura web

---

## O que a troca para Apache prova e o que ela não prova

Trocar o servidor web de LiteSpeed para Apache por alguns minutos separa duas famílias de causa que, do lado de fora, produzem a mesma tela branca ou o mesmo 500:

- **Camada do servidor web**: regras de cache, handlers de PHP, reescritas interpretadas de forma diferente, limites de conexão, diretivas lidas de `.user.ini` ou `.htaccess`.
- **Camada da conta**: código do tema, plugin, versão do PHP, extensão faltando, permissão de arquivo, banco de dados.

Se o erro desaparece rodando em Apache, você está na primeira. Se ele persiste igual, está na segunda, e abrir ticket com o provedor vai só queimar hora. É um teste de isolamento, não de diagnóstico fino: ele não diz **qual** diretiva causou, diz **onde** procurar.

O que ele não responde: problemas intermitentes de carga, lentidão de banco e erro que só aparece sob tráfego real. Dez minutos em Apache num horário morto não reproduzem pico.

## O que deixa de funcionar enquanto o Apache está no ar

A documentação oficial da LiteSpeed trata a troca como temporária e reversível, mas o servidor que sobe no lugar é outro software. Tudo que é específico do LiteSpeed deixa de existir durante a janela. Em uma carteira de sites isso importa, porque você pode estar testando o site A e derrubando a performance do site B no mesmo servidor.

| Recurso | Comportamento durante a janela em Apache |
|---|---||
| LSCache (plugin WordPress) | Página deixa de ser servida do cache do servidor; o plugin continua instalado, mas não há quem atenda |
| Cabeçalho `X-LiteSpeed-Cache` | Esperado: some da resposta HTTP, porque quem o emite é o LiteSpeed (não descrito na página citada) |
| Diretivas PHP via `.user.ini` | Dependem do handler PHP que o Apache usar na conta; podem não valer |
| `noabort` / CRIU | Esperado: são recursos do próprio LiteSpeed, logo não há equivalente rodando em Apache (não descrito na página citada) |
| Conexões longas, SSE e WebSocket | Mudam de comportamento conforme a configuração e os módulos do Apache |
| QUIC / HTTP/3 | Esperado: deixa de ser oferecido na janela, salvo se houver outra camada à frente entregando HTTP/3 (não descrito na página citada) |

A documentação citada descreve o procedimento de troca temporária, não o comportamento de cada recurso durante a janela: as linhas marcadas como esperado na tabela acima são dedução direta de que o LiteSpeed não está rodando, e não dado publicado. Medir o impacto fica por sua conta.

Tradução prática: todo site do servidor passa a ser servido sem o cache de página do LiteSpeed, e páginas que dependiam desse cache tendem a responder mais devagar. Se o servidor é compartilhado com clientes seus, avise antes. Se é VPS de um cliente só, o risco é contido.

## Os sete passos do teste de 10 minutos

Use sempre na mesma ordem. É o que torna o teste repetível em dez contas diferentes sem virar aventura.

### Congele a evidência antes de mudar qualquer coisa

Reproduza o erro e guarde a prova antes de mudar qualquer coisa. Sem isso você não tem com o que comparar depois.

```bash
# status e cabeçalhos da URL que falha
curl -s -o /dev/null -D - https://exemplo.com.br/pagina-que-quebra

# só o que interessa do cache
curl -sI https://exemplo.com.br/ | grep -i 'x-litespeed-cache\|server\|cache-control'
```

Salve a saída num arquivo com data no nome. Guarde também as últimas linhas do `error_log` da conta e do log do site.

### Escolha a janela e combine a duração com o cliente

Horário de menor tráfego, com o cliente avisado. Combine a duração antes: dez minutos é suficiente para reproduzir um erro determinístico.

### Faça a troca pelo plugin do LiteSpeed no WHM

A troca é feita pelo plugin do LiteSpeed dentro do WHM, na opção de alternar temporariamente para Apache, conforme a [documentação oficial da LiteSpeed](https://docs.litespeedtech.com/shared/lsws/cp/cpanel/temp-switch-apache/). É uma ação de servidor inteiro, não por conta: não existe trocar o servidor web de um único site.

### Confirme por duas vias que a troca aconteceu

Não confie na tela. Confirme pela resposta HTTP:

```bash
curl -sI https://exemplo.com.br/ | grep -i '^server:'
```

O cabeçalho `Server` deve deixar de anunciar LiteSpeed. Mas a ausência da string não prova nada sozinha: o header pode vir omitido, genérico ou mascarado por configuração de `ServerTokens`, por ajuste do cPanel ou por proxy. Antes de concluir qualquer coisa, confirme por uma segunda via: recarregue a tela do plugin no WHM e veja qual servidor ela reporta como ativo. Se as duas vias divergirem, trate como teste não iniciado. Se o `Server` continua anunciando LiteSpeed e a tela do WHM também, você está testando o mesmo servidor de antes e qualquer conclusão será falsa. Causa comum: CDN ou proxy na frente respondendo do cache. Teste direto no IP de origem ou pause a CDN.

### Reproduza o erro na mesma condição de antes

Mesma URL, mesmo método, mesmo usuário logado ou deslogado, mesmo navegador anônimo. Erro que só acontece logado e você testa deslogado não vale como resultado.

### Restaure o LiteSpeed assim que terminar

Restaure o LiteSpeed pela mesma tela do plugin assim que terminar. Não deixe para depois. A documentação oficial trata a mudança como temporária justamente porque o estado esperado do servidor é o LiteSpeed rodando.

### Valide que o cache voltou a responder

```bash
curl -sI https://exemplo.com.br/ | grep -i 'server\|x-litespeed-cache'
```

Você quer ver o `Server` de volta e o cabeçalho de cache reaparecendo depois do primeiro acesso em páginas cacheáveis. Limpe o cache do LSCache no plugin do WordPress e recarregue duas vezes: a primeira resposta tende a vir como `miss`, a segunda como `hit`.

## Tabela de leitura: antes em LiteSpeed, durante em Apache

| Antes (LiteSpeed) | Durante (Apache) | Conclusão | Próximo passo |
|---|---|---|---||
| Erro 500 | Página carrega | Camada do servidor web | Revisar `.htaccess`, regras de reescrita, handler PHP, configuração do cache |
| Erro 500 | Erro 500 igual | Camada da conta | Desativar plugins, trocar tema, conferir versão do PHP e extensões |
| 403 Forbidden | Carrega | Servidor web ou regra de segurança na camada dele | Revisar regras de acesso e reescrita |
| 403 Forbidden | 403 igual | Permissão de arquivo, dono do arquivo ou regra na conta | Conferir permissões, propriedade e `.htaccess` da conta |
| Timeout | Carrega | Limite de conexão ou tempo no servidor web | Revisar timeouts e processos PHP |
| Timeout | Timeout | Código lento ou banco | Log de consulta lenta, profiling do PHP |
| Erro some e volta sozinho | Qualquer | Teste inconclusivo | Reproduzir com condição controlada antes de concluir |

Exemplo fictício de linha de log que você pode encontrar na camada da conta, idêntica nos dois servidores: `PHP Fatal error: Uncaught Error: Call to undefined function ... in /home/usuario/public_html/wp-content/plugins/exemplo/exemplo.php on line 212`. Erro fatal de PHP que se repete em Apache não é do LiteSpeed.

## Como transformar o teste em processo na carteira de clientes

Três coisas transformam isso em processo e não em heroísmo.

**Um arquivo por incidente.** Nome `cliente-data-erro.txt` com: URL, horário, saída do `curl` antes, saída durante, saída depois, conclusão da tabela. Em poucos meses esse acervo responde sozinho a boa parte dos casos novos.

**Um script de coleta.** O mesmo bloco de `curl` para todas as contas, mudando só o domínio. Evita o viés de você testar com headers diferentes em cada site.

**Uma regra de quando não fazer.** Não faça o teste em servidor compartilhado com dezenas de sites de clientes em horário comercial, nem em dia de campanha ou lançamento. O custo de derrubar o cache de todo mundo supera o ganho de isolar um erro que pode esperar até a madrugada.

## A mensagem que você manda ao cliente antes da janela

Use antes, não depois. Texto curto, sem jargão, com a janela nomeada:

> **** Vamos fazer um teste técnico de 10 minutos no servidor, entre 23h e 23h10, para identificar a origem do erro na página X. Durante esse período o site continua no ar, mas pode ficar mais lento porque o cache de alta performance fica temporariamente desligado. Ao final tudo volta à configuração original e eu te mando o resultado do teste.

Se o cliente perguntar por que não dá para testar sem impacto: o teste serve justamente para trocar a peça suspeita e ver se o sintoma some. Não existe trocar a peça e manter o comportamento dela.

## O que fazer com cada um dos três resultados possíveis

Se o erro era da camada do servidor web, você tem um alvo pequeno: `.htaccess`, regras de reescrita, configuração de cache, handler e versão do PHP da conta. Comece desativando o LSCache no WordPress e testando de novo com LiteSpeed rodando normal: muita coisa atribuída ao servidor é regra de cache mal configurada, e isso você mesmo resolve.

Se o erro era da conta, pare de escrever para o suporte do provedor e vá para o ciclo clássico: desativar plugins em bloco, reativar um a um, trocar para um tema padrão, conferir versão do PHP e extensões. É trabalho seu, e agora você pode cobrá-lo sabendo que não é infraestrutura.

Se o resultado foi inconclusivo, não repita o teste no escuro. Volte para o log e encontre uma condição que reproduza o erro 10 vezes em 10 tentativas. Teste de isolamento só vale com sintoma determinístico.

