Como corrigir cURL error 28: timeout no WordPress
O que é o cURL error 28 (timeout) no WordPress?
O cURL error 28 é o código que a biblioteca cURL retorna quando uma requisição HTTP não recebe resposta dentro do tempo permitido (“Operation timed out” ou “Connection timed out”). No WordPress, ele surge quando o site usa wp_remote_get/wp_remote_post para falar com uma API externa, com o servidor de updates do WordPress.org ou consigo mesmo (loopback), e essa chamada demora demais. O número 28 é específico de timeout, diferente de outros erros cURL como o 7 (não conseguiu conectar) ou o 60 (certificado SSL inválido).
Como identificar
- A Saúde do site mostra “A requisição de teste de loopback do REST API falhou” ou “cURL error 28: Operation timed out after 10000 milliseconds”.
- Tarefas agendadas (WP-Cron) não rodam e o painel acusa “cURL error 28: Connection timed out”.
- Plugins que consultam APIs externas (frete, pagamento, IA) falham com a mensagem cURL error 28.
- A verificação de atualizações trava e o WordPress avisa que não conseguiu se conectar ao servidor de updates.
Como prevenir
- Use um cron real do servidor (crontab chamando o wp-cron.php) em vez do WP-Cron por loopback em sites com tráfego
- Monitore as APIs externas que seus plugins consomem para detectar lentidão antes que vire timeout
- Mantenha o DNS do servidor saudável e peça ao host para confirmar que conexões de saída na 443 estão liberadas
Causa
- Requisição de loopback bloqueada (o servidor não consegue chamar a própria URL por firewall, DNS interno ou autenticação básica).
- API externa lenta ou fora do ar que não responde dentro do timeout padrão do WordPress (5s a 10s).
- Timeout do cURL/PHP curto demais para a operação (default_socket_timeout baixo).
- Firewall do servidor ou regra de segurança da hospedagem bloqueando conexões de saída (porta 443/80).
- DNS lento ou mal configurado no servidor, atrasando a resolução do domínio de destino além do limite.
Como resolver
- Identifique qual chamada está estourando o tempo: vá em Ferramentas > Saúde do site > Informações e veja se o erro cita loopback (o site chamando a si mesmo) ou um domínio externo. Isso separa problema de servidor de API de terceiro fora do ar.
- Teste o loopback manualmente: acesse pela URL do seu site /wp-cron.php no navegador. Se demorar muito ou der erro, o servidor não está conseguindo se chamar e o cron real está parado por isso.
- Aumente o timeout das requisições do WordPress: via FTP, adicione ao functions.php do tema (ou a um plugin de snippets) um filtro que eleva o tempo limite das chamadas HTTP de 5 para 30 segundos:
add_filter( 'http_request_timeout', function() { return 30; } ); - Desative WP-Cron e use um cron real do servidor: se o erro for no cron por loopback, desligue o cron interno no wp-config.php e agende o wp-cron.php no painel da hospedagem (a cada 5 minutos):
define( 'DISABLE_WP_CRON', true ); - Peça ao host para liberar conexões de saída: se o destino é externo e responde rápido fora do servidor, o firewall da hospedagem pode estar bloqueando a saída. Abra um chamado pedindo a liberação das portas 80 e 443 para conexões de saída.
// functions.php do tema (ou plugin de snippets)
// Eleva o timeout das requisicoes HTTP do WordPress de 5s para 30s
add_filter( 'http_request_timeout', function( $timeout ) {
return 30; // segundos
} );
// Aplica o mesmo teto tambem ao loopback do cron/REST
add_filter( 'http_request_args', function( $args ) {
$args['timeout'] = 30;
return $args;
} );Perguntas frequentes
O que significa exatamente o número 28 no cURL error?
Por que o cURL error 28 aparece na requisição de loopback?
Aumentar o timeout resolve de vez o cURL error 28?
O erro afeta o WP-Cron. Meu agendamento parou?
Como sei se a culpa é de uma API externa e não do meu servidor?
O cURL error 28 tem relação com SSL?
Como aumentar o limite de memória PHP no WordPress
Aumentar o limite de memória PHP no WordPress significa elevar o valor de memory_limit que o servidor reserva para cada execução de script. O ajuste resolve travamentos e a mensagem "Allowed memory size exhausted", comuns em sites com muitos plugins, builders ou importações pesadas.
Como aumentar max_input_vars no WordPress
O limite baixo de max input vars no WordPress faz o PHP descartar campos quando um formulário, menu ou tela de opções envia mais variáveis do que o teto permite (padrão 1000). O resultado é menu cortado ao salvar e configurações que somem sem nenhum erro visível.
Como corrigir Maximum Execution Time Exceeded no WordPress
O erro Maximum Execution Time Exceeded aparece quando um script PHP ultrapassa o número de segundos que o servidor permite por requisição (padrão 30s). O WordPress aborta a operação no meio, comum em importações, atualizações e backups longos.
Como resolver Resource Limit Reached (erro 508) no WordPress
O erro Resource Limit Is Reached (508) no WordPress aparece quando o site ultrapassa a cota de CPU, memória, processos ou entradas que o plano de hospedagem permite. O servidor bloqueia novas requisições até o consumo cair.
Como corrigir um arquivo .htaccess corrompido no WordPress
Um .htaccess corrompido no WordPress é o arquivo de configuração do Apache com regras inválidas ou conflitantes. Ele derruba o site com erro 500, quebra os permalinks (404 em todas as páginas) ou bloqueia o acesso. Restaurar o conteúdo padrão resolve.
Erro crítico no seu site: como resolver
O erro crítico no WordPress é a mensagem que substitui o site inteiro por uma tela em branco com o aviso "Houve um erro crítico neste site". Ele aparece quando um erro fatal de PHP (de um plugin, tema ou do PHP em si) impede o WordPress de terminar de carregar a página.
