Solucionar error 502 Bad Gateway en WordPress (cPanel)

¿Qué significa exactamente el error 502 Bad Gateway?

Antes de ponernos manos a la obra, es fundamental que entiendas qué está pasando. Cuando visitas tu sitio de WordPress y te encuentras con el temido 502 Bad Gateway, lo que te está diciendo el servidor es que hubo un problema de comunicación entre dos partes.

Piensa en ello como una cadena de producción. Tu visita al sitio web entra primero por un "guardia de seguridad" (el servidor web, normalmente Apache o Nginx). Este guardia necesita pasar tu solicitud al "trabajador" que realmente genera la página (el procesador PHP). Si el guardia no recibe respuesta del trabajador a tiempo, o si el trabajador se ha bloqueado, el guardia te muestra el error 502.

En el contexto de WordPress con cPanel, este error es muy común y, afortunadamente, en la mayoría de los casos, tiene solución en pocos minutos. No es un problema de tu ordenador ni de tu conexión a internet; es un problema del servidor donde está alojada tu web.

A lo largo de esta guía, vamos a explorar las causas más frecuentes y, lo más importante, te daré soluciones paso a paso, claras y sin tecnicismos, para que puedas solucionar el error 502 wordpress cpanel y recuperar tu sitio web.

Diagnóstico inicial: ¿El error es tuyo o de todos?

Lo primero que debemos hacer es saber si el problema es general o solo lo ves tú. Esto nos ahorrará mucho tiempo.

Comprueba si tu web está caída para todos

Existen herramientas online gratuitas como "Down For Everyone Or Just Me". Solo tienes que introducir tu dominio y te dirá si el sitio está caído a nivel global.

Si la herramienta dice que el sitio está caído, el problema es del servidor.
Si dice que está en línea, pero tú ves el error 502, el problema puede ser de tu caché local o de tu conexión.

Prueba con otro navegador o modo incógnito

A veces, una extensión del navegador o una caché corrupta puede dar lugar a un falso error 502.

Abre una ventana de incógnito en tu navegador (Ctrl+Shift+N en Chrome, Ctrl+Shift+P en Firefox).
Escribe tu dominio y pulsa Enter.

Si el sitio carga en modo incógnito, el problema es local. Borra la caché y las cookies de tu navegador habitual.

Las 5 causas más comunes y sus soluciones

Si el problema persiste, vamos a entrar en el servidor. Vamos a ver las causas más habituales de los problemas 502 wordpress y cómo atajarlas desde cPanel.

1. PHP se ha quedado colgado o agotado (La causa más frecuente)

En un servidor, PHP funciona como un proceso que se inicia y se detiene constantemente. Si hay demasiadas peticiones a la vez, o si un plugin de WordPress está mal programado, PHP puede colapsar.

Solución paso a paso:

Accede a tu cPanel. Normalmente es tudominio.com/cpanel o tudominio.com:2083.
Busca la sección "Software" o "Motor de aplicaciones". El nombre puede variar según el proveedor, pero generalmente verás "MultiPHP Manager" o "Select PHP Version".
Entra en esa opción y verás una lista de dominios y la versión de PHP que usan.
Cambia la versión de PHP (por ejemplo, si tienes PHP 7.4, cámbiala a PHP 8.0 o 8.1, y luego vuelve a cambiarla a la original). Esto fuerza a que el proceso de PHP se reinicie por completo.

[TIP] Este truco de "apagar y encender" PHP resuelve el error 502 en un 80% de los casos. Es rápido, seguro y no pierdes ninguna configuración.

Solución alternativa (si lo anterior no funciona):

Si no te atreves a cambiar la versión, puedes reiniciar PHP desde la terminal. Pero no te preocupes, no necesitas ser un experto.

En cPanel, busca la opción "Terminal" (suele estar en la sección "Avanzado").
Se abrirá una ventana negra (consola). Escribe el siguiente comando y pulsa Enter:
killall -9 php-fpm (si tu servidor usa PHP-FPM)
O
killall -9 lsphp (si tu servidor usa LiteSpeed).
Después de unos segundos, el sistema reiniciará PHP automáticamente.

2. Límite de memoria de PHP agotado

WordPress es un "glotón" de recursos, especialmente si tienes muchos plugins. Si un plugin intenta usar más memoria de la permitida, el servidor devuelve un error 502.

Solución: Aumentar el límite de memoria (memory_limit).

Ve a "Administrador de archivos" en cPanel.
Busca la carpeta public_html (o la carpeta donde está instalado tu WordPress).
Busca el archivo llamado .htaccess. IMPORTANTE: Es un archivo oculto, así que asegúrate de tener activada la opción "Mostrar archivos ocultos (dotfiles)" en la esquina superior derecha del administrador de archivos.
Haz clic derecho sobre él y selecciona "Editar".
Al final del archivo, añade estas líneas:

<IfModule mod_php7.c>
php_value memory_limit 256M
php_value max_execution_time 300
</IfModule>

Guarda los cambios y prueba tu web.

[WARNING] Si tu servidor usa PHP-FPM (lo más común hoy en día), editar .htaccess no funcionará. En su lugar, deberás crear un archivo llamado .user.ini en public_html con el mismo contenido (sin las etiquetas IfModule). Simplemente pega:
memory_limit = 256M
max_execution_time = 300

3. Un plugin o tema está causando el conflicto

Los plugins son la causa principal de los problemas 502 wordpress. Uno mal actualizado o incompatible puede provocar un conflicto fatal.

Solución: Desactivar todos los plugins.

No puedes entrar al panel de administración porque el error te lo impide. Así que lo haremos por FTP o por el Administrador de Archivos.

Ve al "Administrador de archivos" de cPanel.
Navega a public_html/wp-content/.
Verás una carpeta llamada plugins. Haz clic derecho sobre ella y selecciona "Renombrar".
Cámbiale el nombre a plugins_old (o cualquier otro nombre). Esto desactiva todos los plugins a la vez, porque WordPress no los encuentra.
Vuelve a tu web y comprueba si el error 502 ha desaparecido.

Si el error desaparece: El problema era uno de tus plugins. Ahora, renombra la carpeta de nuevo a plugins, y ve activando los plugins uno a uno desde tu panel de WordPress (ya podrás entrar) hasta encontrar al culpable.
Si el error persiste: El problema no son los plugins. Renombra la carpeta a plugins de nuevo y sigue con la siguiente solución.

[TIP] Si no quieres renombrar toda la carpeta, puedes renombrar un plugin individual (ej. plugin-sospechoso a plugin-sospechoso-inactivo) para desactivar solo ese. Es más lento pero más preciso.

4. El caché del servidor está corrupto

A veces, el caché generado por tus plugins de caché (como W3 Total Cache o WP Super Cache) se corrompe y provoca conflictos.

Solución: Vaciar el caché manualmente.

En el "Administrador de archivos", ve a public_html/wp-content/.
Busca las carpetas llamadas cache (puede haber varias). No las borres, pero entra en ellas y borra TODO el contenido que haya dentro (archivos y subcarpetas).
También busca una carpeta llamada wp-content/updraft o wp-content/backup – si existe, ignórala.
Después de vaciar el caché, recarga tu web.

5. Problemas con el certificado SSL o DNS

Aunque menos común, un error 502 también puede deberse a un problema de configuración del certificado SSL (el candadito de seguridad).

Solución: Forzar la reemisión del SSL.

En cPanel, busca la sección "Seguridad" y entra en "SSL/TLS Status".
Verás tu dominio en la lista. Haz clic en "Run AutoSSL".
Espera unos minutos y comprueba si el error se ha solucionado.

Si tienes acceso a la gestión de DNS de tu dominio, también puedes probar a cambiar los servidores DNS por los de Google (8.8.8.8 y 8.8.4.4) temporalmente para descartar problemas de propagación.

Soluciones avanzadas (si nada de lo anterior funciona)

Si has llegado hasta aquí, el problema es más profundo. No te desanimes, aún quedan opciones.

Revisa el registro de errores (Error Log)

Este es un paso de "detective". Te dirá exactamente qué está fallando.

En cPanel, busca la sección "Métricas" y entra en "Errores" o "Registros de errores".
Busca el archivo error_log dentro de tu carpeta public_html (también puedes verlo desde el Administrador de archivos).
Ábrelo y busca las líneas que contengan la fecha y hora en la que empezó el error 502. Verás mensajes como "Allowed memory size exhausted" o "Fatal error: Call to undefined function".

Qué hacer con la información: Si ves un mensaje de error que menciona un plugin específico (ej. /plugins/mi-plugin/funcion.php), ya sabes que ese es el problema. Repite la solución del punto 3 pero solo con ese plugin.

Comprueba si tu servidor está sobrecargado

Si tu web recibe mucho tráfico de repente, el servidor puede no dar abasto.

Solución a corto plazo: Activa un plugin de caché eficaz (como WP Rocket o LiteSpeed Cache) para reducir la carga.
Solución a largo plazo: Habla con tu proveedor de hosting para aumentar los recursos de tu plan.

Contacta con tu proveedor de hosting

Si todo lo demás falla, el problema es del servidor (hardware, configuración del firewall, etc.). No es tu culpa.

Abre un ticket de soporte con tu proveedor.
IMPORTANTE: Diles que ya has hecho los pasos anteriores (cambio de PHP, desactivado de plugins, vaciado de caché). Esto les ahorrará tiempo y te lo agradecerán.

[INFO] Si tu hosting es de tipo "compartido" y usas un panel alternativo como Syspanel, el proceso es idéntico. Solo recuerda que el acceso a Syspanel se realiza a través del puerto 2106 (ej. tudominio.com:2106). Las opciones de "MultiPHP" y "Administrador de Archivos" están en los mismos menús.

Preguntas frecuentes (FAQ) sobre el error 502

¿El error 502 significa que mi web ha sido hackeada?
No, en absoluto. Es un error de comunicación del servidor. No tiene nada que ver con la seguridad.

¿Puedo perder mis datos si intento las soluciones?
No, todos los pasos que hemos visto son reversibles y no borran tu base de datos ni tus entradas. Incluso al renombrar la carpeta de plugins, solo la "escondes" temporalmente.

¿Cuánto tiempo tarda en arreglarse?
Depende de la causa. El cambio de versión de PHP tarda 1 minuto. La desactivación de plugins, 5 minutos. Si tienes que contactar con el soporte, puede tardar horas.

¿Por qué me pasa tan a menudo?
Suele ser por plugins mal optimizados o por un límite de memoria muy bajo en tu plan de hosting. Si te ocurre con frecuencia, considera cambiar a un plan superior o a un hosting gestionado para WordPress.

¿El error 502 es lo mismo que el 500?
No. El error 500 es un error "genérico" del servidor. El 502 es específicamente un error de "puerta de enlace" (Bad Gateway), que como explicamos al principio, es un problema de comunicación entre el servidor web y el procesador PHP.

Resumen final y consejo de oro

Hemos recorrido un largo camino. Para que no te pierdas, aquí tienes el orden de actuación recomendado:

Prueba con otro navegador para descartar problemas locales.
Cambia la versión de PHP desde cPanel (el "reinicio" mágico).
Aumenta el límite de memoria en .htaccess o .user.ini.
Desactiva los plugins renombrando la carpeta plugins.
Vacía el caché manualmente.
Reemite el SSL.
Contacta con tu proveedor.

El error 502 es frustrante, pero es uno de los problemas más comunes y con más documentación en el mundo del hosting. Con este artículo, tienes un mapa claro para solucionar el error 502 wordpress cpanel por ti mismo.

Espero que esta guía te haya sido de gran ayuda. Si tienes más dudas, no dudes en dejarlas en los comentarios. ¡Buena suerte y a por tu web!