Error 504 Gateway Timeout y 502 Bad Gateway en WordPress: Causas, Logs y Solución

Los errores 504 Gateway Timeout y 502 Bad Gateway representan algunas de las caídas de servicio más frustrantes en sitios desarrollados con WordPress. A diferencia de un error 404 (página no encontrada) o un error 500 (error interno del código), las fallas del grupo 502/504 están estrechamente vinculadas a la infraestructura de red, el rendimiento del hosting y la comunicación entre servidores intermediarios (proxies, CDNs) y el proceso de PHP.

En esta guía técnica analizamos qué significan estos códigos de estado HTTP, cómo revisar los registros de errores (error logs) y cuáles son las soluciones directas desde el panel de control de tu hosting.

Diferencias Técnicas entre Error 502 y Error 504

Para resolver la falla rápidamente, es clave entender qué le ocurrió a la cadena de peticiones de tu servidor:

502 Bad Gateway: Ocurre cuando un servidor principal (como Nginx, LiteSpeed o Cloudflare) actúa como proxy y recibe una respuesta inválida o corrupta por parte del servidor backend que procesa PHP (PHP-FPM o Apache).
504 Gateway Timeout: Ocurre cuando el servidor proxy se queda esperando la respuesta de PHP-FPM o de la base de datos MySQL, pero se agota el tiempo de espera configurado (timeout) antes de completar el procesamiento.

Cuadro Comparativo de Causas y Diagnóstico

Síntoma	Causa Principal Frecuente	Ubicación de la Solución
Error 502 repentino	PHP-FPM colapsado o proceso muerto por falta de memoria RAM.	Panel del Hosting / Aumento de `memory_limit`.
Error 504 en cargas largas	Script de plugin superó el `max_execution_time`.	Archivo `php.ini` / `.htaccess` / `user.ini`.
502/504 tras instalar CDN	Configuración incorrecta en Cloudflare o reglas WAF bloqueando peticiones.	Panel de la CDN / Modo de Desarrollo.
Error 504 al importar datos	Base de datos sobrecargada o peticiones HTTP externas trabadas.	Optimización de MySQL / Desactivación de cron job.

Paso a Paso para Solucionar el Error en tu Servidor

1. Revisa los Registros de Errores (Error Logs)

Antes de modificar archivos, consulta la causa exacta en el servidor:

Accede a tu panel de control (cPanel / Plesk / CyberPanel).
Abre la herramienta Métricas > Errores o revisa la ruta /wp-content/debug.log (si tienes activo el modo WP_DEBUG).
Si ves mensajes como PHP Fatal error: Allowed memory size exhausted o upstream timed out, habrás localizado el cuello de botella.

2. Incrementa los Recursos de PHP en el Hosting

Aumentar los límites de ejecución evita que las consultas complejas de WordPress queden interrumpidas. Modifica tu archivo php.ini o .htaccess con estos valores recomendados:

Ini, TOML

; Configuración recomendada para PHP en php.ini
max_execution_time = 300
max_input_time = 300
memory_limit = 256M
post_max_size = 64M
upload_max_filesize = 64M

3. Reinicia el Servicio PHP-FPM

Si tienes acceso a un servidor VPS o panel con permisos de administrador, reiniciar el socket de PHP liquida los procesos bloqueados o colgados consumiendo CPU al 100%:

Bash

# Para servidores con Ubuntu/Debian y Nginx
sudo systemctl restart php8.2-fpm

4. Purga la Caché del Servidor y CDN

Si utilizas Cloudflare o módulos de caché a nivel de servidor como LiteSpeed Cache / Nginx FastCGI Cache, borra la caché por completo. En muchas ocasiones, la CDN guarda en memoria la página de error 502/504 a pesar de que el servidor web de origen ya se ha recuperado.

Preguntas Frecuentes (FAQ)

¿Un plugin de WordPress puede causar un error 504?

Sí. Si un plugin realiza llamadas a APIs externas lentas, envía correos masivos sin colas de fondo o ejecuta consultas complejas a la base de datos sin índices optimizados, superará el tiempo de espera del servidor y generará un error 504.

¿Qué hago si el error persiste tras cambiar de hosting?

Si migraste de hosting y el error continúa, el problema proviene de la base de datos de WordPress (tablas de opciones infladas como wp_options) o de incompatibilidad entre versiones de PHP y temas/plugins desactualizados.