Qué significa 503 Service Unavailable
Un 503 comunica una indisponibilidad temporal. No sirve como sustituto general de un error de aplicación, de una página que no existe, de un control de acceso ni de la decisión de retirar algo de forma permanente. La cabecera Retry-After puede indicar cuándo podría ser razonable un nuevo intento, pero no garantiza el comportamiento del rastreador ni que la página se mantenga en el índice.
Regla de decisión y evidencias
Usa el 503 solo para una condición operativa acotada y restablece las respuestas normales en cuanto se resuelva. Una eliminación definitiva necesita su propia decisión, con 404 o 410; un defecto que hay que corregir no debe disfrazarse de mantenimiento programado.
Flujo de trabajo práctico
HTTP/1.1 503 Service Unavailable
Retry-After: 3600
Cache-Control: no-storeLa respuesta de mantenimiento debe probarse por la misma capa de borde que usan los visitantes y los rastreadores. Comprueba una ruta normal, un recurso estático y la ruta de recuperación una vez terminada la ventana; de lo contrario, un proxy inverso o una caché pueden seguir sirviendo la respuesta temporal aunque la aplicación ya esté sana.
- Define la ventana de mantenimiento y las rutas que de verdad no están disponibles.
- Sirve una respuesta de mantenimiento sencilla para el usuario, con estado 503.
- Añade un valor realista de Retry-After solo si se conoce el tiempo estimado de recuperación.
- Vigila una URL principal, los recursos críticos y la respuesta una vez terminado el mantenimiento.
- Anota la hora de inicio y de fin, y confirma que vuelve la respuesta 2xx normal o la redirección prevista.
Verificación y errores habituales
Usa un cliente HTTP ajeno a la interfaz de la aplicación para capturar el estado y la cabecera Retry-After. Después, comprueba una ruta pública principal tras la recuperación; una página de mantenimiento que sigue en caché como 503 es un defecto operativo.