Como corrigir o erro cURL 28: Tempo limite da conexão excedido no WordPress?

Se você administra um site WordPress e de repente se depara com o temido erro cURL 28: Tempo limite da conexão excedido, não entre em pânico. Essa mensagem de erro geralmente significa que o WordPress tentou fazer uma requisição cURL, como uma à API REST ou uma transferência de dados, mas a operação expirou antes de receber uma resposta.

Isso geralmente acontece devido às configurações de SSL, limites do servidor, firewalls, endereços IP bloqueados ou até mesmo software desatualizado em sua hospedagem.

Em termos simples, seu site está tentando "conversar" com outro servidor, mas não recebe a resposta no tempo esperado em milissegundos, o que pode fazer com que recursos que dependem da resposta da API REST (como ações em massa ou atualizações) falhem.

A boa notícia? Geralmente, é possível corrigir o erro 28 do cURL no WordPress com alguns ajustes, como atualizar a biblioteca cURL, verificar os recursos do servidor ou pedir da sua empresa de hospedagem ajuda à equipe de suporte

Neste tutorial, explicaremos por que isso acontece e os passos para resolver o problema, para que seu site volte a funcionar sem problemas.

O que causa o erro 28 do cURL no WordPress?

O erro cURL 28 de tempo limite do WordPress geralmente ocorre quando seu site tem dificuldades para concluir um processo de transferência de dados dentro do tempo esperado. Na prática, isso significa que recursos importantes que dependem da API REST ou de uma solicitação de loopback podem não funcionar corretamente, e o site pode não conseguir executar atualizações ou tarefas em segundo plano.

Algumas das causas mais comuns incluem:

• Resposta lenta do servidor ou limites de tempo limite: Se o seu servidor de hospedagem estiver sobrecarregado ou se as suas de PHP restringirem o tempo de execução de uma solicitação, a conexão poderá expirar antes de ser concluída com sucesso.

• Firewall ou plugin de segurança bloqueando solicitações: Camadas extras de segurança em softwares web às vezes desabilitam o acesso a certas APIs externas, o que pode ser um erro se você depende delas para atualizações ou integrações.

• Erros de DNS ou verificação SSL: Um nome de host mal configurado ou um erro de verificação SSL incorreto podem impedir a transferência segura de dados. Até mesmo algo pequeno como um certificado SSL pode causar o problema.

• Conflito de plugin ou problema de tema: Um único conflito de plugin ou um tema desatualizado pode interromper o JavaScript ou as requisições POST necessárias para a comunicação com a API. Em alguns casos, basta atualizar ou renomear a pasta do plugin em conflito para resolver o problema.

• Restrições de hospedagem: Alguns provedores de hospedagem bloqueiam determinadas solicitações de saída para economizar recursos, o que limita sua capacidade de realizar tarefas como baixar atualizações ou conectar-se a serviços de terceiros.

Resumindo, a possibilidade de erro é alta sempre que o WordPress é impedido de fazer uma chamada externa, seja por problemas de hospedagem, configuração ou relacionados a plugins.

Como diagnosticar o erro 28 do cURL no WordPress

Antes de corrigir o problema, você precisará descobrir a causa. O WordPress oferece diversas maneiras de depurar e diagnosticar erros do cURL para que você não perca tempo tentando adivinhar.

Eis como começar:

• Ferramenta de verificação de integridade do site: Acesse Ferramentas → Integridade do Site no painel do WordPress. Essa funcionalidade realiza uma verificação para identificar problemas como falhas em solicitações de loopback, APIs bloqueadas ou respostas lentas que podem ter causado o erro de falha do site.

• Utilize os registros de erros: Sua conta de hospedagem geralmente mantém registros que mostram onde o processo de transferência de dados falhou. Por exemplo, você pode ver solicitações POST repetidas expirando, o que pode indicar um plugin mal configurado ou acesso desativado por parte do seu provedor de hospedagem.

• Teste com diferentes plugins: Às vezes, o problema surge de um conflito entre plugins. Tente desativar os plugins um por um, atualize a página no seu navegador e verifique se a mensagem de erro desaparece. Em muitos casos, atualizar o plugin ou usar uma alternativa resolve o problema.

• Verifique a configuração de DNS e SSL: Certifique-se de que o nome do host e as configurações de SSL estejam corretos. Mesmo pequenos erros na configuração de SSL podem impedir o funcionamento do cURL.

• Simulação com ferramentas: Os desenvolvedores podem usar a depuração do PHP ou verificações externas de linha de comando cURL para testar a mesma solicitação fora do WordPress. Isso ajuda a confirmar se o problema está no próprio WordPress, no seu servidor ou em uma API externa.

Ao executar essas verificações, você pode identificar rapidamente se o problema está relacionado ao seu servidor de hospedagem, à configuração de plugins ou à configuração do software web, economizando tempo na solução de problemas e aproximando-o de uma solução permanente.

Leia aqui: Como rastrear qualquer trecho de código no WordPress

Soluções passo a passo para corrigir o erro 28 do cURL

Aqui está um guia passo a passo para ajudá-lo a corrigir o erro 28 do cURL:

Passo 1: Aumentar o limite de tempo limite do cURL no WordPress

Um dos motivos mais comuns para o erro 28 do cURL é que a solicitação demora muito para ser concluída. Por padrão, o WordPress e seu servidor podem ter um limite de tempo limite muito baixo. Aumentar esse limite garante que as chamadas e solicitações de API externas tenham tempo suficiente para serem processadas.

Para isso, você pode adicionar um filtro simples no arquivo functions.php do seu tema ou um plugin personalizado. Isso aumenta o tempo permitido antes que a solicitação expire.

add_filter( 'http_request_timeout', function() { return 60; // tempo limite em segundos });

Embora o valor padrão seja geralmente em torno de 15 segundos, aumentá-lo para 60 segundos costuma resolver problemas quando os servidores estão sob carga pesada ou quando as APIs demoram mais para responder.

Etapa 2: Adicione os endpoints da API à lista de permissões nos plugins de segurança/firewall

Plugins de segurança como SolidWP, Wordfenceou Sucuri frequentemente bloqueiam solicitações de saída se as considerarem suspeitas. Da mesma forma, firewalls de servidor podem restringir o acesso a determinados endpoints de API. Se a API à qual você está tentando se conectar estiver bloqueada, o cURL retornará o erro 28.

Eis o que você pode fazer:

• Acesse as configurações do seu plugin de segurança e adicione o URL ou domínio específico da API à lista de permissões.

• Para firewalls de nível de hospedagem, adicione exceções para os endpoints necessários.

• Se você não tiver certeza, entre em contato com seu provedor de hospedagem para confirmar as regras do firewall.

Esta etapa garante que o WordPress possa se comunicar livremente com serviços externos sem ser bloqueado internamente.

Etapa 3: Verificar certificado SSL e atualizar o pacote de CA

Certificados SSL inválidos ou expirados frequentemente causam problemas de conexão com o cURL. Como o cURL depende de um pacote de CA (Autoridade Certificadora) para verificar a autenticidade dos certificados SSL, um pacote desatualizado pode causar o erro 28.

Para corrigir isso:

• Verifique se o certificado SSL do seu domínio está ativo e instalado corretamente.

• Se você estiver em um serviço de hospedagem compartilhada, peça ao seu provedor de hospedagem para atualizar o pacote de certificados CA do servidor.

• Em servidores VPS ou dedicados, atualize o pacote de certificados CA manualmente (normalmente através do comando update-ca-certificates no Linux).

Manter os certificados SSL e o pacote de certificados da Autoridade Certificadora (CA) atualizados ajuda a estabelecer conexões seguras sem interrupções desnecessárias.

Etapa 4: Verificar a configuração de DNS e do servidor

Às vezes, o problema não está diretamente no WordPress ou no cURL, mas na resolução de DNS. Se o seu servidor não conseguir resolver o nome de domínio do serviço externo com rapidez suficiente, você verá o erro 28 do cURL.

Eis como solucionar o problema:

Utilize ferramentas como dig ou nslookup para testar se o domínio é resolvido corretamente. Exemplo:

cavar exemplo.com nslookup exemplo.com

Limpe o cache DNS do seu servidor para remover registros desatualizados.

Uma configuração DNS adequada garante uma resolução de domínio rápida e precisa, reduzindo as chances de erros de tempo limite.

Passo 5: Desative temporariamente os plugins conflitantes

Outra causa frequente do erro 28 do cURL no WordPress são os conflitos de plugins. Alguns plugins, especialmente aqueles que gerenciam cache, segurança, conexões de API ou solicitações externas, podem interferir nas operações do cURL.

Eis como testar a existência de conflitos:

• Desative temporariamente os plugins que possam estar usando chamadas de API (como plugins de cache, conectores de API ou ferramentas de integração de terceiros).

• Após a desativação, verifique se o erro persiste.

• Reative os plugins um por um para identificar o plugin exato que está causando o problema.

Se você encontrar um plugin que esteja causando conflito, pode entrar em contato com o desenvolvedor para obter uma correção, procurar um plugin alternativo ou ajustar suas configurações para evitar o bloqueio de solicitações de saída.

Passo 6: Entre em contato com seu provedor de hospedagem

Às vezes, o erro está além do seu controle. Os provedores de hospedagem, especialmente em ambientes de hospedagem compartilhada, podem impor restrições às conexões de saída para conservar recursos do servidor ou melhorar a segurança. Isso pode impedir que o WordPress faça chamadas à API externa.

O que você deve fazer:

• Abra um chamado de suporte com seu provedor de hospedagem e explique que você está enfrentando o erro 28 do cURL.

• Peça-lhes que verifiquem os registros do servidor em busca de solicitações de saída bloqueadas.

• Solicite que eles adicionem à lista de permissões os endpoints da API com os quais você está tentando se conectar.

Um bom provedor de hospedagem deve ajudá-lo a solucionar problemas de servidor rapidamente e garantir uma comunicação tranquila entre seu site WordPress e serviços externos.

Passo 7: Atualize seu plano de hospedagem, se necessário

Se o seu site estiver hospedado em um servidor sobrecarregado ou com recursos insuficientes, ele pode não ter capacidade suficiente para lidar com solicitações cURL de forma eficaz. Isso é comum em ambientes de hospedagem compartilhada de baixo custo, onde vários sites competem pelos mesmos recursos.

Eis o que você pode fazer:

• Monitore o desempenho do seu servidor (CPU, uso de memória e processamento de requisições).

• Se você enfrenta constantemente lentidão nas respostas, considere migrar para um VPS ou uma hospedagem WordPress gerenciada.

• Um host mais confiável garante uma resolução de DNS mais rápida, configurações SSL atualizadas e melhor tratamento de solicitações de API, reduzindo significativamente os erros do cURL.

Ao migrar para um plano de hospedagem de nível superior, você não apenas corrige problemas com o cURL, mas também melhora o desempenho e a estabilidade geral do seu site.

Prevenindo futuros erros de cURL no WordPress

Embora seja importante corrigir o erro 28 do cURL no WordPress, evitar que ele ocorra novamente economiza tempo e evita futuras interrupções. Algumas medidas proativas podem manter seu site saudável e reduzir o risco de problemas de conectividade.

• Mantenha o núcleo, os temas e os plugins do WordPress atualizados: Códigos desatualizados geralmente causam problemas de compatibilidade com APIs e servidores. Atualize regularmente seus temas e plugins do WordPress para garantir que estejam em conformidade com os patches de segurança e melhorias de desempenho mais recentes.

• Utilize um provedor de hospedagem confiável com tempos de resposta do servidor robustos: O desempenho da hospedagem está diretamente ligado à estabilidade do site. Escolher um provedor de alta qualidade garante que seu site tenha os recursos necessários para lidar com chamadas de API externas sem atrasos, reduzindo a probabilidade de timeouts.

• Monitore o desempenho com ferramentas como Pingdom e GTMetrix: Essas ferramentas permitem que você fique de olho nos tempos de resposta do site, no tempo de atividade e na resolução de DNS. Se o desempenho cair, você pode agir rapidamente antes que o problema se agrave e cause erros no cURL do WordPress.

• Otimize regularmente a configuração de DNS e SSL: Certifique-se de que seu domínio aponte para servidores DNS confiáveis ​​(como Cloudflare ou Google DNS) e que seu certificado SSL esteja configurado corretamente e atualizado. Isso garante uma comunicação segura e estável com serviços externos.

Ao aplicar essas práticas recomendadas de otimização do WordPress, você cria uma base sólida que minimiza o risco de problemas de conectividade futuros.

Quando procurar ajuda profissional

Mesmo após tentar todas as etapas de solução de problemas, há momentos em que corrigir o erro 28 do cURL no WordPress pode exigir assistência profissional. Alguns problemas vão além de ajustes básicos no site e necessitam de gerenciamento de servidor de nível especializado.

• Se o problema persistir após tentar as soluções: você aumentou os tempos limite, verificou o SSL, confirmou o DNS e testou os plugins, mas o erro ainda não desapareceu. Isso geralmente indica um problema mais profundo no servidor.

• Casos envolvendo configurações complexas de servidor: Em servidores VPS ou dedicados, configurações personalizadas podem exigir depuração avançada. Configurações incorretas de cURL, PHP ou firewall podem bloquear solicitações de maneiras que somente um administrador de sistemas experiente consegue resolver.

Nessa fase, o melhor é entrar em contato com especialistas em WordPress que se dedicam a diagnosticar e resolver esses problemas. Agências como a SeahawkMedia oferecem suporte profissional para solucionar problemas de desempenho de hospedagem, conflitos de plugins e otimização avançada do WordPress.

Considerações finais

O erro 28 do cURL no WordPress ocorre quando seu site não consegue se conectar a servidores externos a tempo, geralmente devido a limites de tempo limite, problemas de SSL, problemas de DNS, conflitos de plugins ou restrições de hospedagem.

Embora o erro possa parecer técnico, corrigi-lo é crucial porque afeta diretamente o desempenho do seu site, as integrações de API, o posicionamento nos mecanismos de busca (SEO)e a segurança geral.

Seguindo as soluções passo a passo, desde aumentar os limites de tempo limite e adicionar endpoints à lista de permissões até verificar as configurações de SSL, DNS e hospedagem, você pode resolver o problema e evitar que ele se repita.

Se o seu site ainda está apresentando erros de cURL no WordPress, não perca tempo valioso. Uma equipe profissional pode identificar problemas mais complexos no servidor e aplicar as correções adequadas rapidamente.

Perguntas frequentes sobre erros de cURL no WordPress