POST nach Timeout wiederholen: Wann ist es sicher?
Wann lässt sich POST nach einem Timeout sicher wiederholen? Unbekannter Ausgang, Idempotenz und die Grenzen der Schlüssel in Stripe API v1.
Eine hypothetische Notiz-App sendet eine POST-Anfrage, um eine Notiz anzulegen. Die Wartezeit läuft ab, ohne dass eine Antwort eintrifft. Soll sie die Anfrage erneut senden? Dafür sind zunächst zwei Fragen zu trennen: Ist eine Antwort eingetroffen, und wurde die Notiz angelegt?
Die Antwort fehlt, das Ergebnis ist unbekannt
Betrachten wir einen möglichen Ablauf. Der Client sendet die Anfrage. Der Server verarbeitet sie und bestätigt den Schreibvorgang in der Datenbank. Die Antwort geht auf dem Rückweg verloren. Der Client meldet einen Timeout. In diesem Beispiel existiert die Notiz bereits. Wenn jede empfangene POST-Anfrage eine Notiz anlegt, erzeugt die Wiederholung eine zweite.
AWS warnt ausdrücklich: Ein Timeout belegt nicht, dass keine Nebenwirkungen eingetreten sind. „Keine Antwort erhalten“ bedeutet deshalb nicht „Operation nicht ausgeführt“. Darin liegt der Unterschied zwischen einem unbekannten Ergebnis und einem bestätigten Fehlschlag. (builder.aws.com)
Was Idempotenz bedeutet
RFC 9110, Abschnitt 9.2.2, definiert Idempotenz durch dieselbe beabsichtigte Serverwirkung bei einer oder mehreren identischen Anfragen, nicht durch identische Antworten. Von automatischen nicht-idempotenten Wiederholungen wird ohne bekannte idempotente Semantik oder Nachweis der Nichtausführung der ursprünglichen Anfrage abgeraten. (rfc-editor.org)
In der Amazon Builders’ Library beschreibt Malcolm Featonby eine vom Client übergebene Kennung zum Erkennen von Wiederholungen. Gleiche Parameter allein drücken keine Absicht aus: Vielleicht sind tatsächlich zwei identische Objekte gewünscht. Der Schlüssel wirkt durch das vereinbarte Serververhalten, nicht allein durch sein Vorhandensein in der Anfrage. (aws.amazon.com)
Der konkrete Vertrag von Stripe API v1
Stripe API v1 wiederholt gespeicherten Status und Antwortinhalt, einschließlich 500-Fehlern. Gespeichert wird erst nach Ausführungsbeginn: nicht bei fehlgeschlagener Validierung oder Konflikten mit paralleler Ausführung. Geänderte Parameter bei gleichem Schlüssel führen zum Fehler. API v2 hat eine andere Wiederholungssemantik. (docs.stripe.com)
Idempotency-Key gehört bereits zum ersten Versuch. Stripe sieht Wiederholungen mit gleichem Schlüssel und gleichen Parametern innerhalb der ersten 24 Stunden vor. Danach können Schlüssel gelöscht werden; ihre Wiederverwendung kann dann eine neue Anfrage auslösen. Bleibt das Ergebnis unbekannt, sind Wiederholungen zu stoppen und der Ausgang zu klären. (docs.stripe.com)
Wann wiederholt werden sollte, ist eine andere Frage
AWS empfiehlt begrenzte Wiederholungen und wachsende Pausen mit einer Obergrenze zur Lastkontrolle. Davon getrennt ist die technische Schlussfolgerung: Längeres Warten klärt nicht, ob eine Wiederholung korrekt ist. (builder.aws.com)
In seiner Erklärung zu Jitter zeigt Marc Brooker, weshalb gleiche Pausen zeitliche Anfragegruppen bestehen lassen können. Ein Zufallsanteil verteilt die Anfragen. Das verändert ihren Sendezeitpunkt, nicht die Erkennung einer einzelnen Operation durch den Server. (aws.amazon.com)
Was vor automatischen Wiederholungen zu klären ist
Kehren wir als Gedankenübung zur Notiz zurück. Setzen Sie eine Unterbrechung vor der Verarbeitung, nach dem Schreibvorgang und vor dem Antwortempfang an. Notieren Sie jeweils, was der Client weiß, was unbekannt bleibt und welche Stelle im API-Vertrag den nächsten Schritt rechtfertigt. Ersetzen Sie Unbekanntes nicht durch eine Annahme.
Ergänzen Sie anschließend zwei Fragen bei der Prüfung der Integration: „Wie klären wir den Ausgang, wenn die Wiederholungen enden?“ und „Was garantiert dieser Endpunkt in dieser Version genau für diese Operation?“
Quellen
- RFC 9110: HTTP Semantics, section 9.2.2, Idempotent Methods: https://www.rfc-editor.org/rfc/rfc9110.html
- AWS: Timeouts, retries, and backoff with jitter: https://builder.aws.com/content/3EumjoZascWd1oZiEgL8ORlv3qE/timeouts-retries-and-backoff-with-jitter
- Stripe API: Idempotent requests: https://docs.stripe.com/api/idempotent_requests
- Stripe: Advanced error handling: https://docs.stripe.com/error-low-level
- Amazon Builders’ Library: Making retries safe with idempotent APIs: https://aws.amazon.com/builders-library/making-retries-safe-with-idempotent-APIs/
- AWS Architecture Blog: Exponential Backoff And Jitter: https://aws.amazon.com/blogs/architecture/exponential-backoff-and-jitter/