Un error 502 o 504 puede aparecer de repente en una web WordPress que funcionaba correctamente unos minutos antes. A veces desaparece al recargar. Otras veces afecta solo a una operación concreta, como guardar una entrada, abrir el panel, completar un pedido o enviar un formulario.
El mensaje no identifica por sí solo la causa. Un 502 Bad Gateway suele indicar que una capa intermedia recibió una respuesta inválida del siguiente servicio. Un 504 Gateway Timeout indica que una respuesta no llegó a tiempo. En ambos casos puede estar implicado PHP, PHP-FPM, el servidor web, un proxy, una CDN, la base de datos o un plugin que está ejecutando una tarea demasiado pesada.
Reiniciar un servicio puede hacer que el error desaparezca temporalmente, pero no demuestra que se haya corregido la causa.
Antes de tocar nada, delimita el problema
Lo primero es anotar cuándo aparece el error y qué acción lo provoca. No es lo mismo que falle toda la web a que falle únicamente una URL, el área de administración o una petición AJAX.
Comprueba:
- Si afecta a visitantes y usuarios conectados.
- Si ocurre en todas las páginas o solo en una.
- Si aparece al cargar, guardar, subir un archivo o procesar un formulario.
- Si se repite en una franja horaria concreta.
- Si coincide con una actualización, una importación, una copia o una tarea programada.
- Si afecta también al correo u otros servicios del dominio.
Guarda la URL completa, la hora con zona horaria y el código devuelto. Un error intermitente sin hora ni ruta concreta es mucho más difícil de relacionar con los registros del servidor.
Diferencia entre 502 y 504
Un 502 aparece cuando el servidor que actúa como puerta de enlace recibe una respuesta que no puede utilizar: una conexión cerrada, una respuesta incompleta o un servicio que devuelve algo inesperado.
Un 504 suele estar relacionado con un tiempo de espera. La capa que espera una respuesta abandona porque PHP, la base de datos, el servidor de origen o el siguiente proxy no han terminado dentro del límite configurado.
La diferencia orienta, pero no permite señalar automáticamente a PHP o al hosting. Si hay Cloudflare u otra CDN delante, hay que distinguir si el error lo genera la CDN o si está reenviando el error producido por el servidor de origen. Cloudflare recomienda comparar el error del borde con el código devuelto por el origen y revisar la carga, los fallos de red y las aplicaciones que agotan el tiempo de espera. Cloudflare: errores 502 y 504
Cómo saber si el problema está en PHP-FPM
PHP-FPM es una de las piezas que más aparece detrás de los errores intermitentes de WordPress. Puede quedarse sin procesos disponibles, alcanzar un límite de memoria, reiniciarse, bloquearse al ejecutar una tarea o tardar demasiado en responder.
Busca en los registros mensajes relacionados con:
upstream timed out.connect() failed.- Procesos PHP terminados por falta de memoria.
- Límite de trabajadores alcanzado.
- Reinicios de PHP-FPM.
- Errores fatales o excepciones repetidas.
- Consultas que permanecen abiertas demasiado tiempo.
Si el error aparece al ejecutar una acción concreta del panel, revisa qué plugin o tarea se ejecuta en ese momento. Importar miles de productos, regenerar miniaturas, generar un informe o limpiar una tabla grande puede agotar los recursos aunque la portada siga cargando.
No aumentes todos los límites a la vez. Más memoria o más tiempo de espera pueden evitar el síntoma durante unos minutos y hacer que cada proceso consuma todavía más recursos.
Cómo distinguir un problema del servidor
Un servidor saturado suele mostrar otros indicios además del 502 o 504:
- CPU o memoria cerca del límite.
- Disco lleno o sin espacio temporal.
- Procesos PHP acumulados.
- Base de datos lenta.
- Elevado número de peticiones simultáneas.
- Reinicios del servidor o de servicios.
- Errores de conexión entre Nginx, Apache y PHP-FPM.
- Tareas cron ejecutándose al mismo tiempo.
Comprueba los recursos del momento en que se produjo el error, no solo el estado actual. Una web puede parecer normal cuando la revisas porque el proceso que provocaba la saturación ya terminó.
Si el dominio pasa por una CDN, revisa también los registros y métricas de esa capa. Un 502 o 504 generado en el origen no se resuelve cambiando la caché de la CDN. A la inversa, un fallo de comunicación entre la CDN y el origen puede requerir revisar firewall, puertos, certificados o reglas de acceso.
Cuando el problema está en la infraestructura, la gestión de servidores, VPS y cloud permite revisar la cadena completa en lugar de limitarse a WordPress.
Cómo saber si un plugin está provocando el error
Un plugin puede provocar 502 o 504 cuando ejecuta una consulta pesada, realiza una petición externa, procesa muchos archivos o lanza una tarea durante una petición web normal.
Busca una relación temporal entre el error y:
- Una actualización reciente.
- La apertura de una pantalla concreta del administrador.
- Un formulario o proceso de importación.
- La generación de informes.
- Un proceso de optimización o copia de seguridad.
- Un webhook o integración externa.
- Una tarea de WP-Cron.
Desactivar plugins al azar en producción puede ocultar evidencias y romper funciones. Es preferible revisar los registros, reproducir el problema de forma controlada y probar un cambio cada vez. Si se necesita aislar un componente, conserva antes una copia recuperable y documenta qué se ha cambiado.
El mantenimiento y seguridad de WordPress ayuda a controlar actualizaciones, copias y tareas programadas antes de que una incidencia se convierta en una caída.
Cuándo puede ser un problema de rendimiento
No todos los 502 y 504 son fallos de disponibilidad. Una página puede responder correctamente, pero tardar demasiado cuando ejecuta consultas lentas, carga demasiados scripts o depende de un servicio externo que no responde.
En esos casos conviene separar tres preguntas:
- ¿El servidor tiene recursos suficientes?
- ¿WordPress está ejecutando una operación innecesariamente costosa?
- ¿El usuario está esperando una respuesta que debería resolverse de otra forma?
La optimización web y WPO puede ayudar cuando el problema está relacionado con consultas, caché, recursos o procesos lentos, pero no sustituye una revisión del servidor si PHP-FPM está bloqueado o el origen no acepta conexiones.
Qué información conviene recopilar
Antes de pedir ayuda, prepara:
- URL y operación que produce el error.
- Fecha y hora exactas con zona horaria.
- Código visible y contenido de la respuesta.
- Registros de Nginx, Apache, PHP-FPM y WordPress.
- Cambios y actualizaciones recientes.
- Consumo de CPU, memoria y disco.
- Número de procesos PHP activos.
- Presencia de CDN, proxy o firewall.
- Si el fallo afecta a todos los usuarios o solo a una acción.
No compartas contraseñas, cookies, tokens ni copias completas de bases de datos. Los registros pueden contener datos personales, rutas internas y parámetros que también deben revisarse antes de enviarlos.
Un 502 o un 504 es una señal para investigar la cadena completa: navegador, CDN, proxy, servidor web, PHP-FPM, WordPress, plugin y base de datos. Identificar la capa que deja de responder evita aplicar reinicios o aumentos de recursos como única solución.