blog
Infraestrutura web

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.

JR · · 9 min de leitura · 2 tabelas · 2 blocos de código

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
  1. Por que a importação morre no meio
  2. Meça a sua requisição antes de escolher um valor
  3. Marque só a URL longa no .htaccess
  4. Por que ajustar o tempo do PHP pelo painel e não pelo php_value
  5. Como confirmar que a importação concluiu e como desfazer
  6. Quando aumentar o tempo não é a resposta

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:

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.

Três pontos que cortam a requisiçãoTimeout de conexãoAborto ao desconectarLimite do PHP
Três cortes independentes. Corrigir um só não resolve os outros dois.

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

  1. 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).
  2. Pressione F12 e clique na aba Network (Rede).
  3. Marque a opção Preserve log (Preservar log), para a lista não ser apagada se a página recarregar.
  4. Clique no botão que inicia a importação ou o relatório.
  5. Espere até o erro aparecer. Na lista, procure a linha com status 500 (ou a que ficou pendente por mais tempo).
  6. 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

  1. No cPanel, abra Selecionar versão do PHP e clique em Opções, ou abra o MultiPHP INI Editor.
  2. 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.
  3. 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:

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.

Da medição ao valor definitivoMedir a URL exata no DevToolsAnote URL, tempo e statusComparar com max_execution_timeVeja qual limite cortaEstimar a duração realAmostra ou limite temporárioDefinir valor final com folgaSó depois da estimativa
Ordem da medição antes de qualquer alteração de configuração.

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:

  1. No cPanel, abra o Gerenciador de Arquivos.
  2. Entre em public_html (ou na pasta raiz do site).
  3. Se não enxergar o .htaccess, clique em Configurações no canto superior direito e marque Mostrar arquivos ocultos.
  4. 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:

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

  1. 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.
  2. Localize max_execution_time e, antes de mudar, confirme que anotou o valor atual. É ele que você vai restaurar se precisar desfazer.
  3. 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".
  4. 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:

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

  1. Documentação oficial (litespeed) — LiteSpeed cPanel: Long Running Script. Consultado em 2026-11-13.
Leia também