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

So sieht die Meldung aus

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"

Häufige Ursachen

• try_files $uri $uri/ /index.html;, aber /index.html existiert im root nicht (Build fehlt, falscher Pfad).
• root oder ein alias wurde geändert und zeigt nicht mehr auf die ausgelieferte Seite.
• Die in der Konfiguration genannte index-Datei ist nicht da.
• Eine location- oder rewrite-Regel schickt die Anfrage wieder auf sich selbst zurück.
• Eine Single-Page-App wurde ohne ihre index.html ausgeliefert.

Prüfen

1. Die wirksamen Regeln für diese Seite
   nginx -T 2>/dev/null | grep -nE 'server_name|root |alias |try_files|index 'Kopieren
2. Existiert die Rückfall-Datei?
   ls -l /var/www/app/index.htmlKopieren
3. Die genauen Logzeilen
   tail -n 20 /var/log/nginx/error.logKopieren
4. Ist die Konfiguration gültig?
   nginx -tKopieren

Lösung

• root auf das Verzeichnis setzen, das wirklich die index.html enthält.
• Sicherstellen, dass der Build ausgeliefert wurde und index.html vorhanden und für nginx lesbar ist.
• Für eine Single-Page-App try_files $uri /index.html; nutzen und nichts, das auf einen Pfad zurückfällt, der wieder zurückfällt.
• Bei einem alias die Schrägstriche am Ende prüfen und dass try_files einen Pfad darin nutzt.
• Neu laden: nginx -t && systemctl reload nginx.

Häufige Fragen

Warum 500 und nicht 404?

nginx bricht nach 10 internen Umleitungen ab und meldet einen Serverfehler, weil die Schleife ein Konfigurationsproblem ist, keine fehlende Seite.

Kann dieselbe Meldung von einer Rewrite-Regel kommen?

Ja. Ein rewrite ohne last, break oder eindeutige Abbruchbedingung kann ebenfalls schleifen. Jedes rewrite in der passenden Location prüfen.