429 ohne Retry-Sturm behandeln
Produktionsleitfaden: 429 ohne Retry-Sturm behandeln. Enthalten sind ein deterministisches Artefakt, Fehlergrenzen, Rollout-Prüfungen und belegte Einschränkungen.
Produktionsleitfaden: 429 ohne Retry-Sturm behandeln. Enthalten sind ein deterministisches Artefakt, Fehlergrenzen, Rollout-Prüfungen und belegte Einschränkungen.
Entscheidung zuerst
429 ohne Retry-Sturm behandeln ist ein expliziter Produktionsvertrag und keine isolierte Änderung. Erfolg, Endfehler und Rollback müssen vor einer Traffic-Änderung feststehen; das Artefakt trennt Beleg und Annahme.
Beginnen Sie mit classification, belegen Sie retry_after deterministisch und machen Sie terminal zum Release-Gate.
Wiederverwendbares Artefakt
Eine Zeile gilt nur, wenn der Beleg aus derselben Anfrage, demselben Testfenster oder derselben Konfigurationsversion stammt.
| Prüfpunkt | Zu erfassender Beleg | Bestanden wenn |
|---|---|---|
classification |
429_source:_application,gateway,provider,or_shared_pool |
Der Datensatz verbindet logische Anfrage und konkreten Versuch. |
retry_after |
delta-seconds_or_HTTP-date_parsed_against_a_monotonic_deadline |
Der Wert bleibt an der Wire-Grenze exakt erhalten. |
jitter |
bounded_random_delay_after_server_guidance |
Die Grenze ist explizit und schlägt geschlossen fehl. |
attempts |
one_end-to-end_attempt_budget_shared_by_every_layer |
Die Grenze ist explizit und schlägt geschlossen fehl. |
concurrency |
admission_reduced_before_retry_volume_grows |
Die Grenze ist explizit und schlägt geschlossen fehl. |
terminal |
final_429_returned_with_request_ID_and_no_hidden_retries |
Owner, Quelle, Datum und Grenze sind dokumentiert. |
Durchgerechnetes Beispiel
Das Beispiel ist synthetisch und deterministisch. Verwenden Sie geprüfte eigene Werte und niemals Secrets oder Kundendaten.
attempt_budget = 3
for attempt in 1..attempt_budget:
result = call_once()
if result.status != 429: return result
if request.deadline_expired(): break
delay = parse_retry_after(result.headers) ?? bounded_backoff(attempt)
reduce_admission_concurrency()
wait(min(delay + full_jitter(), request.remaining_time))
return terminal_429_without_another_retry()
Umsetzungsverfahren
- Aktuelle Anfrage, Antwort, Konfiguration und Messbasis einfrieren.
- Einen deterministischen Positivfall vollständig erfassen.
- Den passenden Negativ- oder Grenzfall ausführen.
- Alle Versuche über eine logische Request-ID verbinden und Zeit, Endzustand sowie Nutzung ohne sensible Inhalte erfassen.
- Nur in einer begrenzten Kohorte mit Abbruchbedingungen ausrollen.
- Dauerhaften Zustand und öffentliches Verhalten erneut lesen; bei verletzter Invariante zurückrollen.
Fehlermodi
Diese Fehler machen das Ergebnis ungültig, auch wenn der äußere HTTP-Aufruf erfolgreich wirkt:
- Unbegrenzte Retries verstärken die Last.
- Cancellation erreicht weder Queue noch Upstream und verbraucht weiter Kapazität.
- Eine Textantwort gilt fälschlich als vollständiger Kompatibilitätsnachweis.
- Prompts, Schlüssel oder sensible Argumente landen in Telemetrie.
Modelflare-Grenze
Modelflare bündelt OpenAI-kompatibles Routing, Schlüssel, Gruppen, Nutzung und Fehlerbehandlung. Eine konfigurierte Route beweist jedoch keine optionale Provider-Fähigkeit. Modell und Kanal nativ prüfen, explizite Nullwerte erhalten und nur die dauerhafte Abrechnung als Billing-Wahrheit verwenden.
Die übergeordnete Anleitung beschreibt die Entscheidungsgrenze, die Dokumentation die aktuelle Client-Konfiguration.
Checkliste vor Veröffentlichung
- Kernfrage vor dem Hintergrund beantworten.
- Jedem Feld, Zustand, Messwert und jeder Formel einen Owner geben.
- Nur synthetische Kennungen verwenden.
- Struktur, Code, Grenzen und Hinweise in allen Sprachen erhalten.
- Verträge, Support und Preise an T-1 neu prüfen; bei Änderung verschieben.
- Vor dem Termin aus Public API, Routen und Sitemap ausschließen.
Quellen und Prüfdatum
Quellen geprüft am 2026-08-07; sie beweisen keine ungetestete Route.