Un error 503 Service Unavailable indica que el servidor está temporalmente incapaz de manejar la solicitud. A diferencia de 500 (error inesperado) o 502 (bad gateway), 503 específicamente señala una condición temporal que puede resolverse—típicamente sobrecarga, mantenimiento o agotamiento de recursos. Dentro de la clase 5xx de los códigos de estado HTTP, el 503 es único porque indica explícitamente a los clientes que reintenten más tarde.
Qué Significa 503 Service Unavailable
Per RFC 9110, 503 indica “el servidor está actualmente incapaz de manejar la solicitud debido a una sobrecarga temporal o mantenimiento agendado.”
503 vs 502 vs 504
| Código | Significado | Implicación |
|---|---|---|
| 503 Service Unavailable | Servidor no puede manejar solicitud ahora | Temporal, reintentar más tarde |
| 502 Bad Gateway | Respuesta inválida del upstream | Upstream crasheó o mal configurado |
| 504 Gateway Timeout | Upstream no respondió | Upstream muy lento |
Causas Comunes de 503 Service Unavailable
- Sobrecarga del Servidor
- Mantenimiento Agendado
- Agotamiento de Recursos
- Aplicación No Lista
- Circuit Breaker Abierto
El Header Retry-After
La respuesta 503 debe incluir un header Retry-After:
HTTP/1.1 503 Service UnavailableRetry-After: 120Content-Type: application/jsonCómo Corregir Errores 503
- Escalona Recursos
- Implementa Rate Limiting — en Azion, configura reglas de rate limiting en Edge Firewall para proteger el origen antes de que llegue sobrecargado
- Agrega Circuit Breakers — implementable en Edge Functions sin depender de la infraestructura de origen
- Implementa Enfileiramiento
- Degradación Graciosa
Diagnóstico en Azion: Real-Time Events → filtra por
status = 503. Correlaciona conupstream_statuspara determinar si el 503 fue generado por el edge o propagado desde el origen.
Preguntas Frecuentes
¿Cuál es la diferencia entre 503 y 502? 503 significa que el servidor está temporalmente sobrecargado o en mantenimiento. 502 significa que el proxy recibió una respuesta inválida del upstream.
¿Debo reintentar en 503? Sí, 503 es explícitamente reintentable. Verifica el header Retry-After para orientación.
¿Cuánto tiempo debe ser Retry-After? Depende de la causa: mantenimiento (tiempo de fin conocido), sobrecarga (30-120 segundos típico), circuit breaker (tiempo de reset configurado).