5xx · Errores del servidor

Error 503 Service Unavailable: qué significa y cómo solucionarlo

El error 503 Service Unavailable indica que el servidor está temporalmente sin capacidad para atender la petición: está en mantenimiento, sobrecargado o ha alcanzado el límite de conexiones. A diferencia del 500, es un estado temporal y el servidor puede indicar con Retry-After cuándo volver a intentarlo.

Qué significa el código 503

Es el código correcto para una página de mantenimiento: le dice a Google "vuelve más tarde" y no desindexa nada si el corte dura poco. Servir la página de mantenimiento con 200 sería un error: Google podría indexar el aviso en lugar de tu contenido.

Si aparece sin que haya mantenimiento, el servidor se está quedando sin recursos: procesos, memoria, conexiones a la base de datos o el límite de peticiones de nginx (limit_conn, limit_req sin limit_req_status).

Causas habituales del error 503

Mantenimiento programado.
Pico de tráfico que agota los procesos o la memoria.
Ataque DDoS o bots agresivos.
Límite de recursos del plan de hosting (CPU, procesos de entrada).
Todos los backends del balanceador marcados como no sanos.

Si eres visitante de la web

Espera y vuelve a intentarlo; si la web indica una hora de vuelta, respétala.

Cómo solucionar el error 503

Para mantenimiento, responde 503 con Retry-After y una página explicativa.
Revisa carga y memoria (uptime, htop) y los procesos de la aplicación.
Pon una caché delante (Cloudflare, Varnish) para que los picos no lleguen al servidor.
Si es un ataque, activa el modo "Under Attack" de Cloudflare o limita por IP.

Configuración y comandos

nginx: modo mantenimiento con 503

nginx

server {
    if (-f /var/www/mantenimiento.flag) { return 503; }
    error_page 503 @mantenimiento;
    location @mantenimiento {
        add_header Retry-After 1800 always;
        root /var/www/estatico;
        rewrite ^ /mantenimiento.html break;
    }
}
# activar: touch /var/www/mantenimiento.flag

Ejemplo de respuesta

http

HTTP/1.1 503 Service Unavailable
Retry-After: 1800
Content-Type: text/html

Herramientas para comprobarlo

Preguntas frecuentes

¿Qué significa error 503?

Que el servidor no puede atender la petición en este momento por mantenimiento o sobrecarga. Es temporal: normalmente se resuelve solo en minutos.

¿Un 503 en mantenimiento perjudica el SEO?

No, si dura poco (horas). Es justo el código que Google recomienda para mantenimientos. Si dura días, Google empieza a retirar páginas.

Códigos relacionados

Ver todos los códigos de estado HTTP