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.

Resposta curta: 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.
Neste artigo
- O que a troca para Apache prova e o que ela não prova
- O que deixa de funcionar enquanto o Apache está no ar
- Os sete passos do teste de 10 minutos
- Tabela de leitura: antes em LiteSpeed, durante em Apache
- Como transformar o teste em processo na carteira de clientes
- A mensagem que você manda ao cliente antes da janela
- O que fazer com cada um dos três resultados possíveis
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.iniou.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.
# 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. É 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:
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
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:
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.
Referências
- Documentação oficial (litespeed) — Temporarily Switch to Apache. Consultado em 2026-09-30.