blog
Infraestrutura web

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.

JR · · 7 min de leitura · 2 tabelas · 3 blocos de código

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
  1. O que a troca para Apache prova e o que ela não prova
  2. O que deixa de funcionar enquanto o Apache está no ar
  3. Os sete passos do teste de 10 minutos
  4. Tabela de leitura: antes em LiteSpeed, durante em Apache
  5. Como transformar o teste em processo na carteira de clientes
  6. A mensagem que você manda ao cliente antes da janela
  7. 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:

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.

Teste de 10 minutos em cinco etapasCongelar evidênciacurl e logs antes de mudarCombinar janelaHorário morto, cliente avisadoTrocar no WHMPlugin LiteSpeed, servidor inteiroConfirmar e reproduzirDuas vias, mesma URL e condiçãoRestaurar e validarLiteSpeed de volta, cache respondendo
Sequência fixa do teste de isolamento. Mesma ordem em qualquer conta.

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 ler o resultado do testeErro some em ApacheCamada do servidor webAlvo pequeno.htaccess, reescrita, cache, handler PHPErro continua igualCamada da contaCiclo clássicoPlugins, tema, versão do PHPErro vai e voltaTeste inconclusivoReproduzir antes de concluirSó vale sintoma determinístico
Leitura do resultado: três saídas possíveis e o próximo passo de cada uma.

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

  1. Documentação oficial (litespeed) — Temporarily Switch to Apache. Consultado em 2026-09-30.
Leia também