cURL error 28

cURL error 28 en WordPress: causa y solución definitiva

cURL error 28 en WordPress: causa y solución definitiva

cURL error 28 es de los fallos que más veces nos llegan al soporte y también de los que más disgustos provocan: aparece cuando una petición HTTP de tu sitio supera el tiempo máximo de espera y el sistema corta la conexión. Lo verás normalmente en el escritorio de WordPress, en el comprobador de salud del sitio o en la pantalla de actualización de plugins y temas, con el mensaje «cURL error 28: Operation timed out». Lo bueno es que casi siempre tiene solución rápida en cuanto localizas la causa, que suele estar en el servidor, en un plugin conflictivo o en la API externa a la que intentas conectar. En esta guía te explicamos qué significa exactamente, por qué se produce y cómo diagnosticarlo paso a paso. Y si prefieres delegar el problema, en RedServicio (redservicio.net) encontrarás ayuda profesional especializada en WordPress y administración de servidores.

¿Qué significa el error cURL error 28 en WordPress?

WordPress se apoya en la librería cURL (a través de la clase WP_Http y de funciones como wp_remote_get() o wp_remote_post()) para comunicarse con servicios externos: el directorio oficial de plugins y temas, las API de actualización, servicios de correo, pasarelas de pago, plugins de SEO que consultan datos de Google Search Console, antivirus como Wordfence que descargan sus firmas… y un largo etcétera.

Pues bien, cuando cualquiera de esas peticiones tarda más de lo permitido (por defecto, 5 segundos en el caso del comprobador de salud del sitio, o el timeout definido en cada petición), cURL cancela la operación y devuelve el error 28, que significa literalmente operation timed out: la operación excedió el tiempo límite. Fíjate en un detalle que mucha gente pasa por alto: el error no dice que el servidor destino esté caído, solo que la respuesta no llegó a tiempo.

Ejemplo típico: instalas un plugin y te aparece «Descarga fallida. cURL error 28: Connection timed out after 10000 milliseconds». WordPress intentaba descargar el paquete desde wordpress.org y la conexión no se completó dentro del tiempo establecido.

Causas más comunes del cURL error 28

El timeout puede originarse en tres puntos de la cadena: tu servidor, la red y el servidor remoto. Estas son las causas que más vemos en la práctica:

  • Bloqueos del firewall del servidor. ModSecurity, CSF o reglas iptables mal configuradas pueden bloquear las conexiones salientes hacia wordpress.org o hacia API de terceros.
  • DNS lento o mal resuelto. Un resolvedor DNS saturado en el servidor hace que cada petición pierda segundos valiosos antes de conectar.
  • Saturación de recursos. Un servidor con la CPU o la RAM al límite, o con poca memoria para PHP, no atiende las peticiones salientes a tiempo.
  • Plugins de seguridad u optimización agresivos. Cortafuegos como Wordfence, o plugins de cache con llamadas externas, pueden ralentizar o bloquear peticiones.
  • Servidor remoto saturado o bloqueando tu IP. Las API de terceros (sobre todo las gratuitas) aplican límites de tasa y pueden rechazar o simplemente ignorar tus peticiones.
  • Versiones obsoletas de cURL, OpenSSL o TLS. Un servidor con TLS antiguo puede fallar el handshake HTTPS con servicios modernos.
  • Hosting con IP en listas negras. Algunos servicios bloquean rangos completos de IPs de hostings compartidos por spam previo de otros usuarios.

Diagnóstico previo: cómo identificar el origen del timeout

Antes de tocar nada, conviene saber de qué lado está el problema. Nosotros seguimos siempre este orden:

  1. Consulta el informe de salud del sitio. En Herramientas, Salud del sitio verás las peticiones que fallan y hacia qué dominio, lo que te dice qué servicio está provocando el timeout.
  2. Revisa los logs. Activa WP_DEBUG_LOG y consulta el error_log de PHP y el access/error log de tu servidor para localizar la petición exacta que falla.
  3. Prueba la conexión desde el servidor. Por SSH, ejecuta: curl -I –max-time 10 https://api.wordpress.org. Si responde rápido, el problema está dentro de WordPress (plugins o configuración); si no responde, el problema está en el servidor o la red.
  4. Comprueba el DNS. Ejecuta dig api.wordpress.org o nslookup api.wordpress.org y mide la latencia de respuesta.
  5. Descarta plugins conflictivos. Desactiva plugins de seguridad y cache temporalmente, o usa el modo de recuperación si el error te bloquea el escritorio.
  6. Verifica los recursos del servidor. Revisa el uso de CPU, memoria y los límites de PHP (memory_limit, max_execution_time) en tu panel de hosting.

Con estos pasos tendrás localizado el punto de fallo en la mayoría de los casos. Y si el diagnóstico se complica, o no quieres arriesgar la estabilidad de tu sitio, el equipo de RedServicio (redservicio.net) puede analizar tu servidor y resolver el error por ti.

Soluciones prácticas paso a paso para el cURL error 28

Tienes el diagnóstico. Ahora toca arreglarlo. Aplica estas soluciones en orden, sin saltarte ninguna: la mayoría de los cURL error 28 se resuelven con los tres primeros pasos, y los demás existen para los casos tercos.

1. Amplía el timeout de cURL en WordPress

WordPress aplica por defecto un límite de 5 segundos a todas sus peticiones HTTP. Es poco. Muy poco para muchas APIs. El filtro http_request_timeout te permite subirlo; añade esto al functions.php de tu tema hijo o a un plugin de funcionalidades:

add_filter( ‘http_request_timeout’, function() { return 30; } );

Con 30 segundos cubres la mayoría de APIs lentas sin comprometer la estabilidad del sitio. ¿Más? Puedes, claro. Pero no subas de 60 salvo que tengas una razón justificada.

2. Ajusta el timeout en el plugin responsable

Si el error procede de un plugin concreto (un constructor de páginas, un plugin de caché externa o un módulo de pagos), revisa primero sus ajustes: muchos permiten configurar el tiempo de espera de su API sin tocar código. Si no lo permiten, localiza la llamada en su código y modifica el parámetro:

$response = wp_remote_get( $url, array( ‘timeout’ => 30 ) );

3. Revisa límites del servidor

Aquí miras tres cosas en php.ini: max_execution_time (mínimo 120), default_socket_timeout (mínimo 60) y la memoria disponible. Si tu panel lo permite (cPanel, Plesk), edítalos directamente desde la interfaz sin tocar archivos. Si no, solicita el cambio a tu proveedor; es un pedido rutinario, no te cortes.

4. Soluciona problemas de DNS

Un resolvedor lento es causa frecuente, y una de las más ignoradas. Cambia a DNS públicos en el archivo /etc/resolv.conf de tu servidor:

  • Cloudflare: 1.1.1.1 y 1.0.0.1
  • Google: 8.8.8.8 y 8.8.4.4

Tras el cambio, reinicia el servicio de red o el contenedor y comprueba con dig o nslookup que las respuestas llegan rápido. Si tardan más de unos milisegundos, algo sigue fallando.

5. Verifica cortafuegos y lista blanca de IPs

¿Tu servidor o el del destino aplica rate limiting? Entonces solicita la inclusión en lista blanca de la IP de tu servidor. En servicios como Cloudflare o en APIs de pasarelas de pago, esto elimina los retrasos de verificación que se comen el timeout. Revisa también las reglas de iptables o del firewall del panel: hay alguna que otra configuración que ralentiza conexiones salientes sin llegar a bloquearlas, lo cual es peor porque no da error claro.

6. Actualiza OpenSSL y cURL

Versiones antiguas generan negociaciones TLS fallidas que consumen el timeout antes de llegar a conectar. En servidores con acceso root:

apt update && apt upgrade libcurl4 openssl

Confirma la versión con php -i | grep -i curl y prueba de nuevo la conexión afectada. Si sigue fallando, el problema estaba en otro sitio. Vuelve al punto uno y repasa el diagnóstico.

Cómo evitar que el error vuelva a aparecer

Resuelto el problema, la pregunta cambia: ¿cómo evito que vuelva? La prevención se apoya en tres pilares: monitorización, mantenimiento y redundancia. Nada exótico, pero requiere constancia.

Monitoriza las peticiones HTTP salientes

Instala un plugin de registro de peticiones HTTP, o configura un cron que ejecute periódicamente wp_remote_get contra las APIs críticas de tu sitio y te avise si la latencia supera un umbral (3 segundos, por ejemplo). Detectar la degradación antes de que cierre el timeout evita parones de servicio. Es la diferencia entre enterarte tú del problema o enterarte tus usuarios.

Mantén el stack actualizado

  • Actualiza PHP a la versión estable soportada por tus plugins.
  • Renueva certificados SSL antes de su caducidad, con renovación automática (Let’s Encrypt con auto-renew).
  • Revisa cada trimestre las versiones de cURL y OpenSSL del servidor.

Reduce la dependencia de APIs externas en tiempo real

Mucha gente llama a APIs que no lo necesitan. Precios, feeds, estadísticas… casi nunca requieren datos en vivo. Almacena las respuestas en caché usando transients de WordPress:

set_transient( ‘mi_api_cache’, $respuesta, 12 * HOUR_IN_SECONDS );

Así, aunque la API externa se ralentice o caiga directamente, tu sitio seguirá sirviendo datos válidos sin bloquear el hilo de ejecución. Esa capa de amortiguación te ahorra más de un susto.

Elige un hosting con garantías de red

Un proveedor con rutas de red estables, DNS rápidos y soporte técnico que entienda estos errores reduce drásticamente la incidencia del cURL error 28. Si tu hosting actual acumula problemas de latencia, el equipo de redservicio (redservicio.net) puede auditar tu entorno y proponerte alternativas optimizadas para WordPress.

Conclusión

El cURL error 28 no es un fallo aleatorio. Significa siempre lo mismo: una petición HTTP saliente superó el tiempo máximo de espera, ya fuera por un timeout demasiado ajustado, lentitud del servidor remoto, problemas de DNS o bloqueos de red. Siguiendo el diagnóstico por capas descrito en este artículo y aplicando las soluciones en orden, prácticamente cualquier usuario puede resolverlo en menos de una hora.

La regla de oro, si quieres apuntarla: primero identifica qué petición falla y hacia dónde; después ajusta el timeout o corrige la causa de red; y por último implementa caché y monitorización para que el problema no reaparezca. Si tras estos pasos el error persiste, hay algo más profundo en el servidor o en la API de destino. En ese caso cuenta con el soporte profesional de redservicio (redservicio.net), donde podemos analizar tu instalación de WordPress, revisar la configuración del servidor y dejar tu sitio funcionando con total estabilidad.

Publicaciones Similares