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

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

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

---

## 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](https://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:

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

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

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

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

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

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

```bash
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 `grep` e salve a saída em um arquivo. É o seu backlog.
- Para cada site da lista: copie o `.htaccess` para backup com data, comente as linhas apontadas, crie ou ajuste o `.user.ini` com 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 site não foi invadido e nenhum arquivo foi perdido. O servidor que entrega as páginas foi atualizado e uma linha antiga de configuração deixou de ser aceita no novo formato. Movemos essa configuração para o lugar correto, o conteúdo e os endereços continuam exatamente os mesmos."

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](https://docs.litespeedtech.com/lsws/cp/cpanel/500-error/). Os trechos de configuração são exemplos ilustrativos, não valores medidos.

