So sieht die Meldung aus
HTTP/2 429
retry-after: 30
203.0.113.5 - - [29/Oct/2026:10:22:41 +0000] "GET /api/items HTTP/2.0" 429 169 "-" "python-requests"Häufige Ursachen
- Ein Client oder Skript sendet zu schnell, ohne Back-off oder Wiederholung, und überschreitet ein Kontingent.
- Ein Rate-Limit in nginx (
limit_reqmitlimit_req_status 429), fail2ban, einer WAF oder dem CDN ist strenger als der echte Verkehr. - Viele Nutzer teilen sich eine IP (Büro, Mobilfunknetz, Proxy) und werden als ein Client gezählt, oder die echte Besucher-IP wird hinter einem Proxy nicht wiederhergestellt.
- Bots, Crawler oder ein Schwachstellen-Scan überlasten die Seite.
- Eine fremde API (die 429 kommt von einem Dritten) hat ihr Kontingent aufgebraucht.
Prüfen
- Wer bekommt 429 im Access-Log (der Status ist im Standardformat Feld 9)?
awk '$9 == 429 {print $1}' /var/log/nginx/access.log | sort | uniq -c | sort -rn | head - Welche Limits sind konfiguriert?
nginx -T 2>/dev/null | grep -nE 'limit_req|limit_conn|limit_req_status' - Was sagt die Antwort zum Limit?
curl -sI https://example.com/ | grep -iE '^(HTTP|retry-after|x-ratelimit)' - Ist die Client-IP im Log die echte Besucher-IP?
nginx -T 2>/dev/null | grep -nE 'real_ip|set_real_ip_from'
Lösung
- Zuerst die Ebene identifizieren: das Access-Log (eigener Server), die Antwort-Header (CDN oder API) und der fail2ban-Status zeigen, wer antwortet.
- Beim eigenen Limit anpassen: zum Beispiel
limit_req zone=perip burst=20 nodelay;mit einer Rate, die zur normalen Nutzung passt. - Hinter einem Proxy die echte Client-IP wiederherstellen (
real_ip_header,set_real_ip_from), damit Nutzer nicht zusammengezählt werden. - Bekannte gute Clients über
geoundmapoder eine Erlaubnisliste vom Limit ausnehmen und missbräuchliche Bots separat sperren. - Als Client:
Retry-Afterbeachten, exponentielles Back-off nutzen, Antworten cachen und Anfragen bündeln.
Typisches Szenario
Dein Python-Skript ruft mit 20 parallelen Threads die API eines Partners ab. Nach wenigen Sekunden antwortet jede zweite Anfrage mit 429 Too Many Requests und dem Header Retry-After: 30. Das Limit liegt vermutlich bei etwa zehn Anfragen pro Sekunde und Schlüssel. Lies als Erstes die Antwort-Header: Retry-After und, falls vorhanden, X-RateLimit-Remaining sagen dir, wie lange du warten musst und wie viel Spielraum bleibt.
Häufige Fragen
Liefert nginx limit_req standardmäßig 429?
Nein, der Standardstatus ist 503. Setze limit_req_status 429;, wenn du den Standardcode willst.
Soll ich sofort wiederholen?
Nein. Warte mindestens die Zeit aus Retry-After, falls vorhanden, und erhöhe die Wartezeit bei jeder Wiederholung, sonst bleibst du begrenzt.
Ist Retry-After eine Zahl oder ein Datum?
Beides ist erlaubt. Der Wert kann eine Anzahl Sekunden sein, etwa 30, oder ein HTTP-Datum. Gute Clients verstehen beide Formen. Fehlt der Header, wartest du mit wachsendem Abstand, statt sofort erneut zu senden.
Was ist exponentielles Backoff mit Jitter?
Nach jedem Fehlversuch wartest du doppelt so lange wie zuvor (1, 2, 4, 8 Sekunden) und addierst einen zufälligen Anteil. Das Wachsen entlastet den Server, der Zufall verhindert, dass viele Clients gleichzeitig wiederkommen. Eine Obergrenze und eine maximale Zahl an Versuchen gehören dazu.
Wie bleibe ich dauerhaft unter dem Limit?
Begrenze die Rate im Client, etwa mit einem Token-Bucket, statt auf 429 zu reagieren. Fasse Anfragen zusammen, wenn die API Sammelabrufe anbietet, und speichere Antworten zwischen, die sich nicht ändern. Die Header mit dem verbleibenden Kontingent kannst du zur Steuerung nutzen, sie sind aber nicht bei jeder API gleich benannt.