Sperre gegen doppelte Versandlabels

Die Prüfung "gibt es schon ein Fulfillment?" allein genügte nicht: Laufen
zwei Anstöße gleichzeitig — der Hintergrunddienst nach der Zahlung und
ein Klick im Admin —, lesen beide "nein" und erzeugen je ein Label. Im
Betrieb heißt das doppeltes Porto und zwei Pakete für eine Bestellung.

Jetzt liegt eine Sperre je Bestellung in der Datenbank statt im Speicher,
damit sie auch zwischen mehreren Prozessen gilt. Der zweite Aufruf
wartet, sieht danach das angelegte Fulfillment und steigt aus.

Gegen den DHL-Sandkasten geprüft: Zwei gleichzeitige Anstöße auf
Bestellung 33 ergeben ein Fulfillment und eine Sendungsnummer. Vorher
waren es bei Bestellung 32 zwei Labels.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
torbinus
2026-10-02 12:55:33 +02:00
parent 4560ed2a37
commit 6d6d3a92a3
@@ -1,4 +1,5 @@
import { createOrderFulfillmentWorkflow } from "@medusajs/core-flows";
import { ContainerRegistrationKeys } from "@medusajs/framework/utils";
/**
* Bestellung zu einer Zahlung.
@@ -43,7 +44,39 @@ export async function bestellungZurZahlung(container: any, paymentId: string): P
* (siehe src/modules/*-fulfillment). Posten ohne Versand — der
* Geschenkgutschein — bleiben außen vor: sie kommen per E-Mail.
*/
/**
* Sperre je Bestellung.
*
* Die Prüfung "gibt es schon ein Fulfillment?" allein genügt nicht: Laufen
* zwei Anstöße gleichzeitig — etwa der Hintergrunddienst nach der Zahlung und
* ein Klick im Admin —, lesen beide "nein" und erzeugen je ein Label. Im
* Betrieb bedeutet das doppeltes Porto und zwei Pakete für eine Bestellung.
*
* Deshalb eine Sperre in der Datenbank statt im Speicher: Sie gilt auch
* zwischen mehreren Prozessen, also etwa zwischen Server und einem Skript.
* Der zweite Aufruf wartet, sieht danach das angelegte Fulfillment und steigt
* aus. Gehalten wird sie nur für die Dauer der Label-Erzeugung.
*/
export async function erfuelleBestellung(container: any, orderId: string) {
let knex: any = null;
try {
knex = container.resolve(ContainerRegistrationKeys.PG_CONNECTION);
} catch {
// Ohne Datenbankverbindung im Container läuft es wie bisher weiter —
// lieber ungesperrt als gar nicht.
}
if (!knex) return erfuelleBestellungIntern(container, orderId);
return knex.transaction(async (trx: any) => {
// hashtext macht aus der Bestell-ID die Zahl, die Postgres für die Sperre
// braucht. Die Sperre endet mit der Transaktion, auch im Fehlerfall.
await trx.raw("select pg_advisory_xact_lock(hashtext(?))", [orderId]);
return erfuelleBestellungIntern(container, orderId);
});
}
async function erfuelleBestellungIntern(container: any, orderId: string) {
const logger = container.resolve("logger");
const query = container.resolve("query");