Cómo solucionar errores HTTP 500, 502 y 503

Los errores 5xx indican un fallo en el servidor, pero cada código apunta a una capa de fallo distinta. Esta guía le ayuda a aislar la capa con rapidez.

Triaje rápido (primeros 5 minutos)

1. Ejecute la URL en Comprobador de sitios web para capturar el estado y los tiempos.
2. Confirme si el problema afecta a una ruta URL o a todos los endpoints.
3. Compruebe si el error es estable o intermitente.
4. Correlacione con despliegues, cambios de configuración o picos de tráfico.

500 Internal Server Error

Un fallo genérico de aplicación o servidor. Causas más habituales: excepción de aplicación no capturada, variable de entorno incorrecta, problema de permisos o llamada a dependencia fallida.

• Revise primero los registros de la aplicación y después los del servidor web.
• Compruebe lanzamientos y migraciones recientes.
• Verifique permisos de archivos y secretos en tiempo de ejecución.

502 Bad Gateway

Suele ser un problema de proxy o puerta de enlace entre Nginx/Apache/balanceador de carga y su aplicación upstream.

• Confirme que el proceso upstream está en ejecución y escuchando en el host/puerto esperado.
• Compruebe desajustes de timeout del proxy y de keepalive.
• Valide el DNS upstream en despliegues en contenedores.

503 Service Unavailable

Servicio temporalmente no disponible, a menudo por sobrecarga, modo de mantenimiento o pools de workers agotados.

• Inspeccione saturación de CPU, memoria y pools de conexiones.
• Compruebe eventos de autoescalado y limitación de velocidad.
• Verifique indicadores de mantenimiento o comprobaciones de salud mal configuradas.

Qué enviar en escalaciones de soporte

• URL + código de estado exacto
• Marca de tiempo de la primera observación (UTC preferido)
• Si el problema es global o específico de una región
• Cualquier despliegue o cambio de infraestructura reciente

Para fallos del lado DNS, consulte nuestra guía de propagación DNS. Para fallos de discrepancia de host en certificados, consulte esta guía SSL.