nginx: rewrite or internal redirection cycle while internally redirecting to "/index.html"

Come appare il messaggio

2026/10/29 09:14:02 [error] 1234#1234: *5678 rewrite or internal redirection cycle while internally redirecting to "/index.html", client: 203.0.113.5, server: example.com, request: "GET /app/ HTTP/2.0"

Cause frequenti

• try_files $uri $uri/ /index.html; ma /index.html non esiste nel root (build mancante, percorso errato).
• Il root o un alias è stato cambiato e non punta più al sito distribuito.
• Il file index indicato nella configurazione non c'è.
• Una regola location o rewrite rimanda la richiesta su se stessa.
• Una single-page app è stata distribuita senza il suo index.html.

Verifica

1. Le regole effettive per questo sito
   nginx -T 2>/dev/null | grep -nE 'server_name|root |alias |try_files|index 'Copia
2. Il file di ripiego esiste?
   ls -l /var/www/app/index.htmlCopia
3. Le righe di log esatte
   tail -n 20 /var/log/nginx/error.logCopia
4. La configurazione è valida?
   nginx -tCopia

Soluzione

• Imposta root sulla cartella che contiene davvero index.html.
• Assicurati che la build sia stata distribuita e che index.html ci sia e sia leggibile da nginx.
• Per una single-page app usa try_files $uri /index.html; e nulla che ripieghi su un percorso che a sua volta ripiega.
• Con un alias controlla le barre finali e che try_files usi un percorso al suo interno.
• Ricarica: nginx -t && systemctl reload nginx.

Domande frequenti

Perché 500 e non 404?

nginx si ferma dopo 10 reindirizzamenti interni e segnala un errore del server, perché il ciclo è un problema di configurazione, non una pagina mancante.

Lo stesso messaggio può venire da una regola rewrite?

Sì. Un rewrite senza last, break o una condizione di uscita chiara può andare in ciclo. Controlla ogni rewrite nella location corrispondente.