Cómo corregir el error 502 Bad Gateway en WordPress

Uno de los aspectos más frustrantes de ejecutar un sitio web es tener que solucionar un error cuando no sabe por qué está sucediendo. Algunos problemas, como el error 502 de puerta de enlace incorrecta, tienen muchas causas potenciales. Esto significa que es posible que deba probar varias soluciones antes de llegar a la correcta. En esta publicación, le mostraremos cómo navegar por este complicado error y resolverlo.

¡Pongámonos a trabajar!

Suscríbete a nuestro canal de Youtube

Qué es el error 502 Bad Gateway (y por qué sucede)

El error 502 de puerta de enlace incorrecta aparece de vez en cuando y, a menudo, significa que hay un problema con su servidor.

Cuando visita un sitio web, su navegador envía una o más solicitudes al servidor que aloja el sitio. Si todo funciona correctamente, ese servidor devolverá la información que solicitó su navegador y se cargará el sitio web. Por otro lado, el error 502 de puerta de enlace incorrecta se produce cuando un servidor devuelve una respuesta "no válida". Esto puede significar que se agotó el tiempo de espera de la conexión o puede ser el resultado de varios otros problemas.

De la Red de desarrolladores de Mozilla, la definición oficial es:

El código de respuesta de error del servidor de puerta de enlace incorrecta 502 del Protocolo de transferencia de hipertexto (HTTP) indica que el servidor, mientras actuaba como puerta de enlace o proxy, recibió una respuesta no válida del servidor ascendente.

Hasta ahora, esto puede parecer simple. Sin embargo, la conexión entre su navegador y la mayoría de los sitios web no es tan sencilla como solía ser. Por ejemplo, la solicitud de su navegador puede enrutarse a través de un servidor proxy antes de llegar al host en cuestión, por lo que puede ser difícil determinar dónde se encuentra el problema. Muchos sitios web también utilizan varios servidores, lo que complica aún más las cosas, ya que cualquiera de ellos podría ser la causa del error 502.

Todo esto significa que hay algunas causas potenciales para este código de error en particular. Podría ser el resultado de:

• Errores en su base de datos.
• Un servidor que ha agotado el tiempo de espera, actualmente no está disponible o simplemente no funciona como se esperaba.
• El servidor está sobrecargado con demasiadas solicitudes. Quizás un ataque DDOS, o incluso un pico de tráfico mayor de lo previsto.
• Un problema con su servidor proxy inverso.
• Scripts PHP defectuosos, cortesía de uno de sus complementos o temas.

La buena noticia es que si el problema es del lado del servidor, es posible que no necesite realizar ninguna acción. En estos casos, su proveedor de alojamiento generalmente saltará al rescate rápidamente (ya que los clientes tienden a no apreciar el tiempo de inactividad). Debe asegurarse de ponerse en contacto con el equipo de soporte de su anfitrión lo antes posible después de recibir el aviso de que su sitio está afectado por un error 502.

Con eso en mente, nos centraremos en qué hacer si el error 502 de la puerta de enlace incorrecta no desaparece por sí solo rápidamente. La mayoría de los sitios web no pueden permitirse el lujo de estar inactivos durante horas seguidas, después de todo, por lo que si este error persiste, es hora de comenzar a solucionar el problema por su parte.

Cómo reparar el error 502 Bad Gateway

Antes de pasar al modo de solución de problemas, hay una prueba rápida que puede ejecutar para determinar si su servidor responde como debería. Puede intentar ejecutar un traceroute, para ver si su servidor es accesible en primer lugar. Si es así, es probable que el problema sea tuyo. Si no es así, es posible que desee ponerse en contacto con su proveedor de alojamiento.

También debe intentar restablecer su enrutador y verificar la configuración de su Sistema de nombres de dominio (DNS). Estas son soluciones básicas que a veces pueden hacer que el error 502 desaparezca, y son bastante fáciles de abordar por su cuenta. Sin embargo, si encuentra que ninguna de las soluciones resuelve el problema, puede utilizar los siguientes métodos para solucionar el error 502.

Limpiar la caché de su navegador

El error 502 puede aparecer cuando intenta acceder a su sitio web, incluso si se ha resuelto el problema subyacente. Esto ocurre si su navegador se basa en su caché, en lugar de cargar la última versión de su sitio desde el servidor.

Con frecuencia, basta con recargar el sitio varias veces. Especialmente si está utilizando la Recarga forzada a través de Shift-CTRL-R en Windows o Shift-CMD-R en Mac.

Si todo lo anterior falla, debe proceder a vaciar la caché de su navegador manualmente. Los usuarios de Chrome pueden hacer esto navegando al menú Configuración> Avanzado y localizando la opción Borrar datos de navegación :

Busque la opción Imágenes y archivos en caché en la pestaña Básico y haga clic en Borrar datos después de seleccionarlo. Tenga en cuenta que este menú también eliminará su historial de navegación, si no deshabilita esa configuración antes de hacer clic en el botón Borrar datos .

Este mismo proceso también se puede completar con Firefox, Safari, Internet Explorer y casi cualquier otro navegador. Cuando haya borrado el caché, intente volver a cargar su sitio web. Si el error persiste, es hora de ponerse serio. Para obtener más información sobre cómo borrar el caché, puede encontrarlo en la página central de Hubspot sobre el tema.

Deshabilite temporalmente su red de entrega de contenido (CDN)

Anteriormente, mencionamos que las solicitudes de su navegador a veces se enrutarán a través de un servidor proxy inverso. En otras palabras, el uso de un servidor proxy coloca un intermediario entre el navegador del usuario y el servidor del sitio web.

Algunos servicios, como las redes de entrega de contenido (CDN), se basan en la tecnología de proxy inverso para enrutar el tráfico entrante de la manera más eficiente posible. Sin embargo, a veces esta capa adicional puede crear problemas cuando intentas conectarte al servidor de origen de un sitio web. Cuando eso suceda, sus visitantes (y usted) podrían encontrarse con el temido error 502 de puerta de enlace incorrecta.

Afortunadamente, es bastante fácil verificar y ver si su CDN está causando este problema. Todo lo que tiene que hacer es deshabilitar temporalmente el servicio y luego probar si su sitio web se carga correctamente sin él. El proceso para deshabilitar su CDN variará según el servicio que esté utilizando, pero generalmente es simple.

Por ejemplo, los usuarios de Cloudflare solo tienen que navegar a la pestaña Descripción general en su panel de control. En el interior, encontrará una lista de propiedades que ejecutan el servicio. Luego, deberá buscar el botón grande de Pausa en la sección Pausar sitio web y hacer clic en él:

Ahora, cuando intente acceder a su sitio web, su servidor de origen responderá a la solicitud sin que ningún intermediario se interponga. Si el error 502 desapareció, entonces su CDN probablemente fue la fuente del problema. En la mayoría de los casos, solo tendrá que esperar unas horas antes de volver a habilitar el servicio. Por supuesto, asegúrese de verificar y asegurarse de que el error aún desaparezca después.

Si está utilizando otro CDN, deberá consultar su documentación para obtener instrucciones sobre cómo deshabilitar temporalmente el servicio. Sin embargo, si su CDN no es el problema, hay una solución más que puede probar.

Probar temas y complementos de WordPress

Hasta ahora, hemos hablado de tres posibles causas detrás del error 502: su servidor, su navegador y servicios de intermediarios como los CDN. Eso solo deja una opción si está seguro de que el problema está de su parte, y ese es su sitio web. Si está ejecutando WordPress específicamente, uno de sus complementos o temas podría estar intentando ejecutar un script que su servidor no puede cargar correctamente. Esto puede resultar en una respuesta no válida cuando su navegador envía una solicitud, lo que desencadena el error 502.

Solo puede tener un tema activo a la vez, por lo que simplemente puede desactivar el actual y cambiar a un tema predeterminado de WordPress temporalmente, para ver si eso resuelve el error. Por otro lado, averiguar si un complemento está causando problemas puede llevar más tiempo, dependiendo de cuántos de ellos estén activos actualmente.

Dado que no tiene acceso a su panel en este momento gracias al error, deberá deshabilitar sus complementos y temas manualmente. Tenga en cuenta que este proceso no implica eliminar los complementos y temas, y reactivarlos solo toma un momento. Por lo tanto, la funcionalidad de su sitio web no debería verse afectada. Aun así, debe tener una copia de seguridad reciente lista por si acaso.

Luego, abra el cliente FTP de su elección. Somos grandes admiradores de FileZilla, así que lo usaremos como ejemplo. Inicie sesión en su sitio web a través de FTP y navegue hasta la carpeta public_html - wp-content - plugins . Debe haber una carpeta para cada uno de los complementos instalados en el interior, incluso aquellos que no están activos:

Si hace clic con el botón derecho en cualquiera de esas carpetas, verá varias opciones, incluida una etiquetada Cambiar nombre . Haga clic en eso ahora y cambie el nombre de la carpeta a algo como disabled.pluginname :

Cuando acceda a su sitio web ahora, WordPress no podrá encontrar ese complemento, por lo que se cargará sin él. Si el complemento que acaba de desactivar estaba causando el error 502, su sitio web debería cargarse correctamente. Solo para estar seguro, recuerde usar el comando CTRL + F5 (o el equivalente de OS X) para forzar a su navegador a eliminar su caché antes de volver a cargar el sitio.

Para evitar confusiones, debe solucionar los problemas de un complemento a la vez. Cambie el nombre de una carpeta, intente volver a cargar su sitio web y vea si todavía muestra el error 502. Si es así, restaure el nombre original de la carpeta. Repita este proceso con cada carpeta hasta que encuentre una que esté causando el error o hasta que haya probado todos los complementos. Puede usar el mismo proceso para probar su tema activo, lo que obligará a WordPress a usar uno de sus temas predeterminados en su lugar.

Si uno de sus complementos o temas está causando el error 502, puede eliminarlo por completo y buscar un reemplazo. Si está desactualizado, también puede intentar actualizarlo para ver si eso resuelve el problema. En algunos casos, la secuencia de comandos del problema se reparará rápidamente, por lo que siempre puede reanudar el uso de ese complemento o tema más adelante.

Otras correcciones rápidas (potenciales)

Ahora, estas correcciones anteriores probablemente encontrarán y corregirán al culpable si el error 502 es causado por algo de su parte y no del servidor. Si no desaparece, recuerde que le sugerimos que se ponga en contacto con su proveedor de alojamiento web para que pueda revisar el servidor y diagnosticar cualquier problema allí.

Dicho esto, puede ayudar a acelerar el proceso realizando un par de comprobaciones rápidas.

La primera de estas comprobaciones es cualquier registro que su sitio pueda haber guardado. Si es WordPress, hay varias formas de verlo. Tenemos un informe sólido sobre el uso de estos registros para mejorar su sitio que puede ser de ayuda aquí. Los sitios de WP que ejecutan versiones 5.0 o superiores están equipados con una herramienta de salud del sitio que puede consultar dentro de su panel de administración, así que asegúrese de ver lo que tiene que decir.

También puede asegurarse de que las cookies de su navegador sean claras. Estos están completamente separados del caché y no siempre queremos borrarlos. Si mantiene alguna información guardada en su navegador, esto la borrará. Pero esas mismas cookies también pueden 502 establecer la conexión entre usted y esos sitios, por lo que puede ser un Catch-22. De cualquier manera, es bastante fácil borrar las cookies en cualquier navegador principal.

Si su sitio simplemente se detiene, es posible que haya algo en segundo plano que solo necesita más tiempo para ejecutarse. Puede aumentar el tiempo de ejecución permitido por un sitio de WordPress simplemente editando su archivo functions.php . Si no está en WP, también puede hacerlo a través de .htaccess o php.ini . Thimpress tiene una guía bastante buena sobre cómo hacer todo esto.

Finalmente, puede verificar si hay errores de DNS. Con eso, queremos decir que ha movido hosts o cambiado a un tipo diferente de plan o servidor. Es posible que haya ajustado los servidores de nombres o cualquier cantidad de cosas que podrían salir mal. La configuración de DNS es muy específica y propensa a configuraciones incorrectas. Así que vaya a su cPanel o panel de control, asegúrese de que todo se alinee entre su host y su registrador de dominio y la configuración de su sitio web. A veces, un cable se cruza o un solo error tipográfico detiene todo en seco. Un poco de corrección de DNS puede ser de gran ayuda aquí.

Y si está realmente interesado en asegurarse de que el DNS esté bien por su parte, puede encender el terminal y vaciar su caché de DNS manualmente.

Conclusión

La solución de problemas de errores de WordPress suele ser más fácil de lo que piensa. Incluso los problemas que tienen muchas causas potenciales, como el error 502 de puerta de enlace incorrecta, se comprenden y documentan bien. Es posible que deba probar varias soluciones antes de encontrar una que funcione, pero el proceso de solución de problemas no debería demorar demasiado si sigue las instrucciones correctas.

Si se encuentra con el error 502 de puerta de enlace incorrecta en su sitio web y no desaparece después de unos minutos (o después de una llamada rápida al equipo de soporte de su anfitrión), es probable que el problema sea de su parte. Simplemente siga los procesos y trucos que mencionamos anteriormente, y usted y sus usuarios deberían estar de regreso en su sitio web en poco tiempo.

¿Alguna vez se ha encontrado con el error 502 de puerta de enlace incorrecta en uno de sus sitios web? ¡Comparta sus experiencias con nosotros en la sección de comentarios a continuación!

Imagen en miniatura del artículo de windwheel / shutterstock.com.