503 Service Unavailable (también verás "Servicio No Disponible Temporalmente") significa que el servidor está arriba pero no puede atender tu petición ahora. Es un código 5xx, pero a diferencia de un 500 es explícitamente temporalel servidor te dice que vuelvas.
Qué causa un 503
| Causa | Qué pasa |
|---|---|
| Sobrecarga | Más tráfico del que la capacidad actual atiende |
| Modo mantenimiento | La app se baja a propósito |
| Límites de recursos | Sin workers, memoria o conexiones de DB |
| Escalado lento | El autoscaling no alcanzó el pico |
| Dependencia caída | Un servicio requerido (DB, caché, API) no está |
503 vs 502 vs 500
- 503 → "Estoy arriba pero no puedo atenderte ahora" (sobrecarga/mantenimiento).
- 502 → "Un servidor del que dependo me dio una respuesta inválida."
- 500 → "Algo en mi código lanzó un error inesperado."
Cómo arreglarlo, como visitante
- Esperá un minuto y recargá, el 503 es temporal por diseño.
- Si hay header
Retry-After, ese es el tiempo a esperar.
Cómo arreglarlo, como desarrollador
- ¿Es mantenimiento? Revisá el flag de maintenance o deploy.
- Capacidad: CPU, memoria, workers, pool de conexiones bajo carga.
- Escalá; confirmá que los umbrales de autoscaling reaccionan a tiempo.
- Revisá dependencias (DB al límite, API downstream).
- Enviá
Retry-Afterpara que clientes y crawlers no te martillen.
Un health check externo que pegue a tus endpoints clave cada minuto y avise ante un spike de 503 te deja escalar antes de que lleguen los tickets.