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.

Resposta curta: 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.
Neste artigo
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 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_timeencerra 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),canceledou uma mensagem que começa comnet::ERR_(por exemplonet::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_timee 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
.htaccesse 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_timee, 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_logda pasta do site) mostraAllowed 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.
Referências
- Documentação oficial (litespeed) — LiteSpeed cPanel: Long Running Script. Consultado em 2026-11-13.