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.htmlexistiert imrootnicht (Build fehlt, falscher Pfad).rootoder einaliaswurde geändert und zeigt nicht mehr auf die ausgelieferte Seite.- Die in der Konfiguration genannte
index-Datei ist nicht da. - Eine
location- oderrewrite-Regel schickt die Anfrage wieder auf sich selbst zurück. - Eine Single-Page-App wurde ohne ihre
index.htmlausgeliefert.
Prüfen
- Die wirksamen Regeln für diese Seite
nginx -T 2>/dev/null | grep -nE 'server_name|root |alias |try_files|index ' - Existiert die Rückfall-Datei?
ls -l /var/www/app/index.html - Die genauen Logzeilen
tail -n 20 /var/log/nginx/error.log - Ist die Konfiguration gültig?
nginx -t
Lösung
rootauf das Verzeichnis setzen, das wirklich dieindex.htmlenthält.- Sicherstellen, dass der Build ausgeliefert wurde und
index.htmlvorhanden 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
aliasdie Schrägstriche am Ende prüfen und dasstry_fileseinen Pfad darin nutzt. - Neu laden:
nginx -t && systemctl reload nginx.
Typisches Szenario
Deine CI-Pipeline baut eine React-Anwendung und kopiert sie auf den Server. Der Build-Schritt ist stillschweigend fehlgeschlagen, das Zielverzeichnis ist leer. Jede URL antwortet nun mit 500, im Log steht „rewrite or internal redirection cycle while internally redirecting to /index.html“, obwohl die Konfiguration unverändert blieb. Prüfe zuerst mit ls -l auf dem Server, ob unter dem Pfad aus root überhaupt eine index.html liegt und wann sie zuletzt geschrieben wurde.
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.
Warum bricht nginx nach genau zehn Umleitungen ab?
Das Limit von zehn internen Umleitungen ist fest im Code verankert und nicht einstellbar. Es schützt den Server vor Endlosschleifen. Wird es erreicht, antwortet nginx mit 500 und schreibt die Meldung ins Fehlerlog; der Besucher sieht den eigentlichen Grund nie.
Wie bekomme ich ein 404 statt der Schleife?
Beende die Fallback-Kette mit =404, etwa try_files $uri $uri/ =404;. Dann liefert nginx bei fehlender Datei ein sauberes 404, und der Fehler fällt im Monitoring sofort anders auf als eine 500. Bei Single-Page-Apps bleibt /index.html als letztes Glied, aber nur, wenn die Datei sicher existiert.
Wie verhindere ich, dass beim Deployment kurz keine index.html existiert?
Deploye in ein neues Verzeichnis und schalte danach einen Symlink um, zum Beispiel ln -sfn releases/42 current, auf den root zeigt. So ist das alte Release bis zum Umschalten vollständig da, und ein fehlgeschlagener Build erreicht gar nicht erst die Live-Seite.