Problema

L'errore 503 Service Unavailable si verifica quando Nginx non riesce a comunicare con il backend (upstream). Questo può accadere per diversi motivi.

Cause Comuni

  • Il servizio backend è spento o non raggiungibile
  • Timeout della connessione upstream
  • Limiti di connessione raggiunti
  • Configurazione proxy_pass errata

Soluzione

1. Verifica lo stato del backend

systemctl status your-backend-service

2. Aumenta i timeout

proxy_connect_timeout 300;
proxy_send_timeout 300;
proxy_read_timeout 300;

3. Configura retry

upstream backend {
  server 127.0.0.1:3000 max_fails=3 fail_timeout=30s;
}