Error 502 Nginx Bad Gateway: causas y cómo resolverlo

Error 502 Nginx: causas y cómo resolver

El error 502 Bad Gateway en Nginx indica que el servidor no pudo obtener una respuesta válida de un servidor upstream. Esto puede causar interrupciones graves en aplicaciones web, afectando la experiencia del usuario y la confiabilidad del servicio.

Este error generalmente ocurre en entornos donde Nginx actúa como un proxy inverso, redirigiendo solicitudes a servidores de aplicación como Node.js, PHP-FPM, entre otros. El impacto técnico es significativo, ya que los usuarios pueden verse impedidos de acceder a funcionalidades críticas de la aplicación.

Causas Probables

• Servidor upstream inactivo o mal configurado
• Problemas de red entre Nginx y el servidor upstream
• Timeouts de conexión
• Errores de configuración en Nginx

Diagnóstico

Para diagnosticar el error 502, siga los pasos a continuación:

1. Verifique los logs de Nginx en /var/log/nginx/error.log para mensajes de error.
2. Cheque si el servidor upstream está en ejecución y accesible.
3. Pruebe la conectividad entre Nginx y el servidor upstream usando curl.

Corrección Paso a Paso

A continuación se presentan los pasos para corregir el error 502:

1. Verifique la configuración del servidor upstream en el archivo de configuración de Nginx:

server {
    listen 80;
    server_name example.com;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

2. Asegúrese de que el servidor upstream está en ejecución:

systemctl status nombre-del-servicio

3. Verifique los timeouts en Nginx:

proxy_read_timeout 90;
proxy_connect_timeout 90;

4. Reinicie Nginx después de realizar cambios:

sudo systemctl restart nginx

Riesgos en Producción

Resolver el error 502 es crítico para la continuidad del servicio. Ignorar este error puede llevar a una experiencia negativa del usuario y pérdida de ingresos. Además, una configuración inadecuada puede resultar en vulnerabilidades de seguridad.

Prevención

Para prevenir futuros errores 502, considere las siguientes prácticas:

• Monitoree la salud del servidor upstream regularmente.
• Implemente un sistema de balanceo de carga.
• Configure alertas para errores en Nginx.

FAQ

¿Qué es un error 502 Bad Gateway?

Es un error que indica que el servidor Nginx no pudo obtener una respuesta válida de un servidor upstream.

¿Cómo puedo saber si el problema está en Nginx o en el servidor upstream?

Verifique los logs de Nginx y pruebe la conectividad con el servidor upstream usando curl.

¿Es seguro reiniciar Nginx para corregir el error 502?

Sí, reiniciar Nginx puede ayudar a aplicar nuevas configuraciones y resolver problemas temporales.

Causa	Síntoma	Cómo Confirmar	Corrección
Servidor upstream inactivo	Error 502	Logs de Nginx	Iniciar el servidor upstream
Timeouts de conexión	Error 502	Logs de Nginx	Aumentar timeouts en Nginx
Problemas de red	Error 502	Prueba de conectividad	Resolver problemas de red

Referencias y próximos pasos

• RFC 9110 — HTTP Semantics
• MDN Web HTTP
• OWASP API Security Project

Para diseñar diagnóstico, autenticación y recuperación desde el inicio, conozca nuestro servicio de APIs e integraciones.