Erro 500 após migrar para LiteSpeed: as 3 causas no log
Três causas distintas produzem a mesma tela branca. O log separa as três, e a correção certa mantém permalinks e redirecionamentos de pé.

Resposta curta: a primeira hipótese é uma diretiva PHP (php_value, php_flag) no .htaccess: o Apache aceitava a linha, o LiteSpeed, com o handler em uso, rejeita. O error_log nomeia o arquivo e a linha. Comente só aquela linha e mova o valor para .user.ini.
Neste artigo
- O que muda quando o Apache vira LiteSpeed e o site não sai do lugar
- Seis checagens que eliminam uma família de causa cada
- O que cada mensagem do error_log significa, em uma tabela
- Diretiva PHP que o LiteSpeed rejeita e para onde o valor se muda
- Memória ou tempo estourado no processo PHP via LSAPI
- Permissão de arquivo e pasta: 644, 755 e dono da conta
- Varra a carteira inteira no mesmo dia da migração
- O que dizer ao cliente e o que não mandar para ele
- Três mensagens de log, três famílias, três correções
O que muda quando o Apache vira LiteSpeed e o site não sai do lugar
O site continua no mesmo caminho, com os mesmos arquivos, o mesmo banco e o mesmo PHP. Só o servidor web que lê o .htaccess é outro. O LiteSpeed lê o mesmo arquivo que o Apache lia, mas não implementa todas as diretivas, e algumas módulo-específicas que o Apache tolerava (ou ignorava porque o módulo não estava carregado) passam a produzir erro de configuração.
A documentação do LiteSpeed sobre 500 no cPanel (docs.litespeedtech.com/lsws/cp/cpanel/500-error) separa o problema em duas famílias: erro na interpretação do .htaccess e erro no processo PHP externo (LSAPI). A terceira família, permissão de arquivo e pasta, aparece como 500 porque o servidor não consegue nem ler o script. São três causas com três mensagens diferentes no log, e é por isso que ler o log antes de mexer economiza a tarde.
O erro que o cliente vê é o mesmo nos três casos: página branca com 500. Daí a ligação.
Seis checagens que eliminam uma família de causa cada
Rode na ordem. Cada passo elimina uma família inteira.
Qual error_log tem o número da linha: o do domínio, não o do servidor
No cPanel, o log por domínio costuma ficar em ~/logs/ ou aparecer em Métricas > Erros. É ele que nomeia a linha do .htaccess. O log global do servidor não vai te dar o número da linha do site do cliente.
Se a mensagem cita um arquivo de configuração, pare nas outras hipóteses
Se a mensagem aponta um caminho terminando em .htaccess com número de linha, você está na família 1 e pode pular as outras. Não renomeie nada ainda.
Neutralize o .htaccess por 60 segundos, só para confirmar, e devolva
Só para confirmar a hipótese, não como solução. São dois blocos, e o segundo só roda depois de você recarregar o site no navegador:
cd ~/public_html
cp .htaccess .htaccess.bak-$(date +%F)
mv .htaccess .htaccess.off
Recarregue o site agora. Em seguida, sem exceção, devolva o arquivo:
cd ~/public_html
mv .htaccess.off .htaccess
Se o 500 some com o arquivo fora, é .htaccess. Devolva o arquivo imediatamente: sem ele, permalink do WordPress, redirect 301 antigo e regra de HTTPS do cliente param. Deixar .htaccess renomeado durante uma hora para "investigar" costuma custar mais em SEO do que o próprio 500.
Comente apenas a linha que o log citou e recarregue
Comente com # a linha que o log nomeou, recarregue, veja se o 500 some. Se a diretiva for de bloco, comente o bloco inteiro, do <IfModule ...> ao </IfModule>.
Processo PHP no log aponta LSAPI, não .htaccess
Mensagens sobre processo que terminou de forma anormal, timeout ou "no response" apontam o PHP externo, não o .htaccess. Família 2.
Permissão negada no log aponta bits e dono do arquivo
Família 3. Checagem de 30 segundos descrita mais abaixo.
O que cada mensagem do error_log significa, em uma tabela
| O que aparece no log | Família | Primeira ação |
|---|---|---|
Caminho do .htaccess + número de linha, com nome de diretiva |
Configuração | Comentar só aquela linha e recarregar |
Referência a <IfModule> ou a módulo do Apache |
Configuração | Mover o conteúdo para o equivalente suportado |
| Processo PHP encerrado de forma anormal | LSAPI | Olhar limite de memória e tempo do PHP |
| Timeout ao esperar resposta do backend PHP | LSAPI | Procurar query lenta ou loop no plugin |
| Permission denied em arquivo ou diretório | Permissão | Conferir dono e bits do caminho citado |
| Script com permissão de escrita para grupo/outros | Permissão | Ajustar para 644 (arquivo) e 755 (pasta) |
A tabela resolve a triagem. O resto do artigo é o que fazer dentro de cada família.
Diretiva PHP que o LiteSpeed rejeita e para onde o valor se muda
A primeira hipótese a testar em migração, pela ordem que a documentação do LiteSpeed sugere: diretivas de PHP escritas no .htaccess. Com PHP rodando como módulo do Apache, php_value e php_flag funcionavam. Com PHP como processo externo (LSAPI, o modelo usado no cPanel com LiteSpeed), o tratamento depende do handler PHP e da configuração do servidor: em parte dos setups essas diretivas são aceitas ou ignoradas, em outros viram erro de configuração e 500. Quem confirma é o log: se ele nomeia o .htaccess e a linha da diretiva, é esse o caso. A página da documentação do LiteSpeed citada acima trata esse cenário como a primeira família a verificar.
O destino da configuração muda conforme o caso:
| O que estava no .htaccess | Onde passa a viver |
|---|---|
php_value memory_limit, upload_max_filesize, max_execution_time |
.user.ini na raiz do site, ou o seletor de versão de PHP do cPanel |
php_flag display_errors e afins |
.user.ini ou php.ini do seletor |
Bloco <IfModule mod_php...> inteiro |
Mesmo destino acima; o bloco sai do .htaccess |
| Regras de cache de página de plugin | Configuração de cache do próprio servidor/plugin, não .htaccess manual |
RewriteRule, Redirect, ErrorDocument, Deny/Require |
Continuam no .htaccess, são suportados |
Exemplo (fictício, para ilustrar o formato) de .user.ini na raiz de um WordPress:
memory_limit = 256M
upload_max_filesize = 64M
post_max_size = 64M
max_execution_time = 120
Dois detalhes que custam tempo quando ignorados: o .user.ini é lido por diretório e vale para o diretório e os de baixo, e a mudança não é instantânea como .htaccess, porque o valor fica em cache por um intervalo configurado no PHP. Se você alterou e nada mudou, espere e teste de novo antes de concluir que não funcionou. E se o cliente tem plano com seletor de versão de PHP no cPanel, prefira o seletor: fica versionado na conta, sobrevive a restauração de backup do public_html e não some quando um plugin reescreve o .htaccess.
Por que comentar a linha e nunca renomear o .htaccess
Renomear o .htaccess inteiro derruba, de uma vez: permalink, HTTPS forçado, redirecionamentos acumulados por anos, bloqueio de xmlrpc.php, regra de wp-login. Você troca um 500 por uma dúzia de 404 e por conteúdo servido em HTTP. Comentar a linha citada mantém tudo o que funcionava.
Registre a linha removida em um comentário no próprio arquivo, com a data. O próximo que abrir vai agradecer:
# 2026-09-25 removido na migracao p/ LiteSpeed, movido para .user.ini
# php_value memory_limit 256M
Memória ou tempo estourado no processo PHP via LSAPI
O sintoma é parecido, mas o log não cita linha de configuração: cita o processo PHP. A documentação do LiteSpeed trata esse caso separadamente justamente porque a correção não é no .htaccess.
O que investigar, na ordem:
- Limite de memória do PHP. Confirme o valor efetivo com
phpinfo()ou com o seletor do cPanel, não pelo que está escrito no arquivo. Arquivo escrito e valor efetivo divergem com frequência quando há.user.iniem subpasta. - Tempo de execução. Importação de produtos, geração de sitemap e backup são os suspeitos de sempre. Rode a tarefa pesada por WP-CLI em vez do navegador quando possível.
- Plugin específico. Desative por grupo, não um a um, se forem muitos: metade deles, teste, depois a metade que sobrou.
- Query lenta. Se o site estoura só em página de listagem ou no admin, olhe o banco antes de pedir upgrade de plano. Plano maior esconde query ruim por alguns meses e o problema volta maior.
Essa última é desconfortável de dizer e verdadeira: boa parte dos 500 por LSAPI que parecem falta de recurso são um plugin fazendo trabalho demais por requisição. Trocar de plano resolve o sintoma. Olhar a consulta resolve a causa.
Permissão de arquivo e pasta: 644, 755 e dono da conta
Aparece depois de restauração de backup, de upload por FTP com cliente mal configurado ou de script que criou arquivo com dono errado. O servidor recusa executar e devolve 500.
O padrão seguro em hospedagem compartilhada: 644 para arquivo, 755 para pasta, dono igual ao usuário da conta cPanel. Arquivo gravável por grupo ou por todos costuma ser recusado pela checagem de ownership e permissão de quem executa o PHP sob o usuário da conta (suEXEC, suPHP e equivalentes). É prática de ambiente compartilhado, não regra do LiteSpeed: confirme no log qual caminho foi recusado.
Checagem rápida do que está fora do padrão:
cd ~/public_html
find . -type f -perm /0022 | head -20
find . -type d -perm /0022 | head -20
E a correção, quando confirmado que é isso:
find . -type f -exec chmod 644 {} \;
find . -type d -exec chmod 755 {} \;
Rode com consciência: há casos legítimos de permissão diferente (cache de plugin, pasta de upload com regra própria). Verifique antes de aplicar no site inteiro. Em WordPress padrão, wp-config.php costuma ficar em 644 ou mais restrito, nunca gravável por todos.
Varra a carteira inteira no mesmo dia da migração
Se você migrou dez contas, não espere dez ligações. Faça uma passada por todas no mesmo dia.
Um grep que lista todos os .htaccess com diretiva PHP
As diretivas PHP no .htaccess são o primeiro alvo da varredura, por serem o padrão recorrente em migração:
grep -rn "php_value\|php_flag\|php_admin_value\|php_admin_flag" \
/home/*/public_html/.htaccess
A saída já dá a lista de sites a tratar, com arquivo e número de linha. Com acesso só por SSH de uma conta, rode dentro de ~/public_html e repita por conta.
A ordem de trabalho que rende em migração de dez contas
- Rode o
grepe salve a saída em um arquivo. É o seu backlog. - Para cada site da lista: copie o
.htaccesspara backup com data, comente as linhas apontadas, crie ou ajuste o.user.inicom os valores equivalentes. - Teste a home, uma página interna (prova que permalink está vivo), o admin e um formulário que envie e-mail.
- Marque o site como feito no arquivo de backlog.
Seis itens de validação depois de corrigir cada site
- Home carrega com 200.
- Página interna carrega (permalink preservado).
/wp-admin/abre e salva uma configuração.- Upload de imagem de tamanho real funciona (prova
upload_max_filesize). - Redirect antigo conhecido ainda redireciona.
- Site responde em HTTPS sem conteúdo misto.
Seis itens, dois minutos por site. É o que separa "migrei" de "entreguei".
O que dizer ao cliente e o que não mandar para ele
O cliente que vê 500 pensa em invasão ou em arquivo perdido. Responda antes que ele pergunte:
O que evitar na comunicação: culpar o provedor, prometer que não vai acontecer de novo em outros sites antes de ter rodado a varredura, e mandar print de log para o cliente. Log é para você. Para ele, vale o antes e o depois com horário.
Se o site ficou fora por tempo relevante, registre o horário de início e fim pelo log de acesso e informe espontaneamente. Cliente que recebe o relato sem pedir não abre chamado.
Três mensagens de log, três famílias, três correções
Três mensagens de log, três famílias, três destinos de correção. .htaccess com linha citada vira comentário mais .user.ini. Processo PHP encerrado vira investigação de memória, tempo e plugin. Permissão negada vira 644 e 755 com dono certo.
E a regra que mais economiza tempo: nunca renomeie o .htaccess como solução. Renomeie por um minuto para confirmar a hipótese, devolva, e corrija a linha. O arquivo que está causando o 500 também é o que segura o SEO do cliente.
Referência usada neste artigo: documentação oficial do LiteSpeed sobre erro 500 em cPanel, docs.litespeedtech.com/lsws/cp/cpanel/500-error. Os trechos de configuração são exemplos ilustrativos, não valores medidos.
Referências
- Documentação oficial (litespeed) — LiteSpeed on cPanel: 500 Error. Consultado em 2026-09-25.