# Erro 500 no meio da importação longa no LiteSpeed

Como descobrir quanto tempo a sua operação leva, liberar só aquela URL no LiteSpeed e manter o limite normal no resto do site.

> no LiteSpeed, marque só a URL da importação no .htaccess com as variáveis noabort e noconntimeout, como mostra a documentação oficial, e ajuste o max_execution_time do PHP para um pouco acima da duração real da operação (não do tempo em que ela era cortada), sem desligar o timeout do site todo.

João Rizzon · 2026-11-17 · Infraestrutura web

---

## Por que a importação morre no meio

Uma importação de produtos, um relatório de vendas de um ano inteiro ou uma geração de backup pelo painel têm algo em comum: são uma única requisição que fica aberta por muito tempo. Enquanto o PHP trabalha, o navegador espera. Se alguém no caminho decide que a espera passou do limite, a requisição é encerrada e o que você vê é um erro 500, uma tela em branco ou uma barra de progresso que para e nunca mais anda.

No LiteSpeed, a [documentação oficial sobre scripts de longa duração](https://docs.litespeedtech.com/lsws/cp/cpanel/long-run-script/) descreve dois pontos em que isso acontece no servidor web, além do limite do próprio PHP:

- **Timeout de conexão:** o servidor encerra a conexão quando ela passa tempo demais sem atividade (tempo ocioso), e não pela duração total da requisição. Um script que trabalha por muito tempo sem enviar nenhuma saída ao navegador cai nesse limite.
- **Aborto quando o cliente desconecta:** se o navegador fecha a conexão (aba fechada, rede que caiu, proxy no meio que desistiu), o LiteSpeed pode interromper o processo PHP que estava atendendo aquela requisição.
- **Limite do PHP:** a diretiva `max_execution_time` encerra o script quando ele passa do tempo configurado.

Os três são independentes. Corrigir só um deles e esquecer os outros é o motivo mais comum de "mudei a configuração e continua dando erro".

Um detalhe de diagnóstico: este artigo trata do corte da requisição longa. Se o erro é 502 Bad Gateway, o problema costuma estar entre o servidor web e o processo PHP (processo que caiu, pool esgotado), e a investigação é outra. Se é 413, o arquivo enviado é grande demais, não lento demais.

## Meça a sua requisição antes de escolher um valor

Antes de mexer em qualquer arquivo, descubra quanto tempo a operação leva de fato e em que momento ela morre. Sem esse número, qualquer valor de timeout é chute. Não fizemos medição própria para este artigo: o número que importa é o do seu site, e você mede assim.

### Como achar a requisição que dá erro 500 no DevTools

- Abra o Chrome ou o Firefox e entre na tela do WordPress que dispara a operação (a página do importador ou do relatório).
- Pressione **F12** e clique na aba **Network** (Rede).
- Marque a opção **Preserve log** (Preservar log), para a lista não ser apagada se a página recarregar.
- Clique no botão que inicia a importação ou o relatório.
- Espere até o erro aparecer. Na lista, procure a linha com status **500** (ou a que ficou pendente por mais tempo).
- Clique nessa linha. Anote três coisas: a **URL** completa (aba Headers), o **tempo total** (coluna Time ou aba Timing) e se a resposta veio do servidor ou se a conexão foi simplesmente cortada. Isso aparece na coluna Status: um número (500, 503, 504) significa que o servidor respondeu. `(failed)`, `canceled` ou uma mensagem que começa com `net::ERR_` (por exemplo `net::ERR_EMPTY_RESPONSE`) significa que a conexão caiu sem resposta.

| O que você anota | Onde aparece | Para que serve |
|---|---|---||
| URL exata da requisição | Aba Headers, campo Request URL | Define qual caminho recebe a regra no .htaccess |
| Tempo até o erro | Coluna Time ou aba Timing | Comparado ao `max_execution_time` atual, indica qual limite está cortando |
| Status retornado | Coluna Status | 500 sugere corte no PHP ou no servidor; 502 aponta para outro problema |
| Parâmetros da URL (depois do `?`) | Aba Payload ou Headers | Necessários quando o importador usa `admin-ajax.php` |

Repita o teste duas ou três vezes. Se o erro aparece sempre perto do mesmo tempo, você encontrou um limite fixo.

### Como saber se o corte vem do limite do PHP

- No cPanel, abra **Selecionar versão do PHP** e clique em **Opções**, ou abra o **MultiPHP INI Editor**.
- Procure `max_execution_time` e anote o valor que aparece (em segundos). Guarde esse número: ele também é o valor para restaurar se precisar desfazer a mudança mais adiante.
- Compare com o tempo que você mediu. Se o corte acontece praticamente nesse valor, o limite que está cortando é o do PHP. Se acontece em outro tempo, o corte vem do servidor web, de um proxy ou de um CDN na frente do site.

### Como estimar quanto a importação leva para terminar

O tempo do corte só mostra onde está o limite atual. Ele não diz quanto a operação levaria para terminar, e configurar o limite logo acima dele provavelmente reproduz o erro. Para estimar a duração real, use uma destas saídas:

- Rode a operação com uma amostra menor (um CSV com uma fração das linhas, um relatório de um mês em vez de um ano), meça o tempo até o status 200 e projete para o volume completo.
- Eleve o limite temporariamente para um valor alto, rode uma vez, anote o tempo total até terminar e depois baixe para o valor definitivo.
- Consulte o log do próprio plugin, quando ele registra início e fim da tarefa.

Só com essa duração em mãos, e alguma folga, defina o valor final do `max_execution_time`.

Atenção a um caso comum: muitos importadores do WordPress dividem o trabalho em vários pedidos curtos a `admin-ajax.php`. Se cada pedido leva poucos segundos e mesmo assim falha, o problema provavelmente não é timeout, e as próximas seções não vão resolver.

## Marque só a URL longa no .htaccess

A documentação do LiteSpeed mostra como desligar, via variáveis de ambiente definidas por `RewriteRule`, os dois cortes do servidor web: `noabort` (não interromper o PHP quando o cliente desconecta) e `noconntimeout` (não aplicar o timeout de conexão). O exemplo da documentação usa o padrão `.*`, que vale para o site inteiro. A recomendação aqui é restringir ao caminho que você mediu, porque desligar o timeout para todas as URLs deixa qualquer requisição travada ocupando um processo por tempo indeterminado.

### Como fazer backup do .htaccess antes de editar

Um erro de sintaxe no `.htaccess` derruba o site inteiro com erro 500. Então:

- No cPanel, abra o **Gerenciador de Arquivos**.
- Entre em `public_html` (ou na pasta raiz do site).
- Se não enxergar o `.htaccess`, clique em **Configurações** no canto superior direito e marque **Mostrar arquivos ocultos**.
- Clique com o botão direito no `.htaccess` e escolha **Copiar**. Salve como `.htaccess.bak`.

Para desfazer qualquer coisa, basta apagar o `.htaccess` editado e renomear o `.htaccess.bak` de volta.

### O bloco que desliga o corte só para essa URL

Edite o `.htaccess` e cole o bloco abaixo **acima** da linha `# BEGIN WordPress`. O caminho é um exemplo fictício: troque pelo que você anotou no DevTools.

```
<IfModule LiteSpeed>
RewriteEngine On
RewriteRule ^relatorios/exportar\.php$ - [E=noabort:1,E=noconntimeout:1]
</IfModule>
```

Linha a linha:

- `<IfModule LiteSpeed>`: o bloco só é lido se o servidor for LiteSpeed. Em Apache ele é ignorado, sem erro.
- `RewriteEngine On`: liga o módulo de reescrita (o WordPress já liga mais abaixo; repetir não causa problema).
- `RewriteRule ^relatorios/exportar\.php$ -`: casa o caminho da URL, sem a barra inicial e sem o domínio. O `-` significa "não reescrever nada", a URL segue igual.
- `[E=noabort:1,E=noconntimeout:1]`: define as duas variáveis que o LiteSpeed lê para não abortar e não aplicar o timeout de conexão naquela requisição.
- `</IfModule>`: fecha o bloco.

### Como filtrar admin-ajax.php pelo parâmetro action

Se o DevTools mostrou que a operação longa é um pedido a `wp-admin/admin-ajax.php`, o caminho sozinho não basta, porque o painel inteiro usa esse arquivo. Filtre pelo parâmetro `action` que você anotou. Exemplo fictício:

```
<IfModule LiteSpeed>
RewriteEngine On
RewriteCond %{QUERY_STRING} action=meu_importador
RewriteRule ^wp-admin/admin-ajax\.php$ - [E=noabort:1,E=noconntimeout:1]
</IfModule>
```

Isso só funciona se o `action` estiver na URL. Se ele vier no corpo de um POST (aparece na aba Payload, não na URL), a condição não casa, e a alternativa é aplicar a regra ao `admin-ajax.php` inteiro, aceitando que outras ações do painel também ficam sem o corte.

Salve e recarregue qualquer página do site. Se aparecer erro 500 imediatamente, restaure o backup e confira se não sobrou caractere a mais.

## Por que ajustar o tempo do PHP pelo painel e não pelo php_value

As variáveis acima cuidam do servidor web. O PHP continua com o próprio `max_execution_time`. Também é possível colocar `php_value max_execution_time` no `.htaccess`, mas o resultado varia conforme o modo em que o PHP roda no servidor: em algumas configurações a linha é aceita, em outras não tem efeito ou gera erro. O painel é o caminho previsível, porque grava o valor onde o PHP de fato lê.

- No cPanel, procure **Selecionar versão do PHP** (às vezes chamado **Select PHP Version**) e clique em **Opções**, ou use o **MultiPHP INI Editor**, conforme o que sua hospedagem oferece.
- Localize `max_execution_time` e, antes de mudar, confirme que anotou o valor atual. É ele que você vai restaurar se precisar desfazer.
- Coloque um valor um pouco acima da duração real que você estimou (não do tempo em que o corte acontecia), e não um número enorme "para garantir".
- Salve.

Essa configuração vale para o site todo, e é por isso que o valor deve sair da medição. Um limite folgado demais faz com que um script com defeito, preso num laço, fique minutos consumindo CPU antes de ser encerrado.

## Como confirmar que a importação concluiu e como desfazer

Repita o teste da seção de medição com o DevTools aberto. O resultado esperado é a requisição passar do tempo em que antes morria e terminar com status 200.

| Sintoma depois da mudança | Leitura provável | O que fazer |
|---|---|---||
| Site inteiro com erro 500 | Erro de sintaxe no .htaccess | Restaurar o `.htaccess.bak` |
| Erro no mesmo tempo de antes | Regra não casou com a URL, ou o limite é do PHP | Conferir o caminho exato e o `max_execution_time` |
| Erro num tempo maior que antes | Um limite foi removido, sobrou outro | Revisar o PHP ou limite do provedor |
| Operação conclui | Corte resolvido | Manter a regra só nessa URL |

Se o erro continuar no mesmo ponto mesmo com tudo certo, pode existir um limite que você não controla pelo `.htaccess`: configuração global do servidor, proxy ou CDN na frente do site, que corta conexões longas por conta própria. Aí a conversa é com o suporte da hospedagem ou do CDN, levando o tempo medido e a URL.

Para desfazer: apague o bloco `<IfModule LiteSpeed>` que você adicionou e volte o `max_execution_time` ao valor que você anotou antes da mudança.

## Quando aumentar o tempo não é a resposta

Nem toda importação que falha precisa de mais tempo. Vale descartar antes:

- **Memória:** se o log de erros do PHP (no cPanel, em **Erros** ou no arquivo `error_log` da pasta do site) mostra `Allowed memory size exhausted`, o script morreu por memória, não por tempo.
- **Arquivo grande demais:** dividir um CSV enorme em partes menores costuma resolver sem tocar em configuração nenhuma, e é a saída mais segura.
- **Rodar fora do navegador:** se você tem acesso SSH, executar a tarefa pela linha de comando (WP-CLI ou cron) tira o navegador e o servidor web do caminho. Muitos plugins de importação e de relatório oferecem essa opção.
- **Consulta lenta:** um relatório que demora pode estar esperando o banco. Olhar o log de consultas lentas do MySQL resolve a causa, enquanto o timeout só esconde o sintoma.

A regra por URL faz sentido quando a operação é legítima, demorada por natureza e eventual. Para o resto, corrigir a causa sai mais barato do que esticar o limite.

