
Viele Magento-2- und Adobe-Commerce-Shops mit MSI (seit 2.4 der Standard) erleben denselben Effekt: Der Checkout wird träge, obwohl CPU und PHP-FPM unauffällig wirken. Häufig sitzt der Engpass nicht im Theme und nicht in GraphQL, sondern in der Tabelle inventory_reservation. Sie ist ein Append-only-Ledger: Jede Bestellung schreibt eine negative Reservierung, Versand, Storno und Gutschrift schreiben Kompensationen. Gelöscht wird erst, wenn Sequenzen auf null stehen – und nur, wenn Cleanup wirklich läuft.
Dieser Beitrag ist eine Betriebsliste, kein Benchmark. Zahlen kommen aus eurer Datenbank, nicht aus einem Beispielshop. In der Magento-2-Betreuung behandeln wir Reservierungen wie Cache-Schichten: erst messen, dann aufräumen, dann kompensieren. Zur Trennung cachebarer Queries bleibt der Beitrag Magento 2 GraphQL-Caching die passende Ergänzung – Frontend-Cache und Reservierungs-Ledger sind zwei verschiedene Lastpfade.
Was Reservierungen tun – und was sie nicht tun
MSI zieht den Bestand beim Bestellen nicht sofort vom Source ab. Es legt eine Reservierung auf Stock-Ebene: verkaufbare Menge minus offene Holds. Die physische Source-Menge ändert sich erst bei Versand (oder analoger Erfüllung). Adobe beschreibt das Ledger so:
- Bestellung: negative Menge, Event
order_placed. - Teilstorno, Versand, Rechnung (virtuell/downloadbar), Gutschrift: positive Kompensation.
- Ist die Order in einem Endzustand (Complete, Canceled, Closed), muss die Summe aller Zeilen dieser Order 0 ergeben.
Die Tabelle ist kein Saldo, den Magento überschreibt. Jede Bewegung ist eine neue Zeile. Deshalb wächst inventory_reservation mit jeder Bestellung – auch dann, wenn der Shop «aufgeräumt» wirkt, weil der Cron kompensierte Sequenzen noch nicht gelöscht hat.
Adobe verlangt ausserdem den Consumer inventory.reservations.updateSalabilityStatus dauerhaft. Ohne ihn bleibt die verkaufbare Menge hinter den Reservierungen zurück. Prüfen: bin/magento queue:consumers:list. Fehlt der Eintrag: bin/magento queue:consumers:start inventory.reservations.updateSalabilityStatus.
Warum der Checkout die Tabelle spürt
Beim Place-Order muss Magento genug verkaufbare Menge nachweisen und eine neue Reservierung einfügen. Dafür liest es offene Reservierungen zum SKU/Stock und schreibt in dieselbe Tabelle. Wird die Tabelle gross und unaufgeräumt, werden diese Reads und Inserts teurer – unter Last oft genau im Checkout, nicht auf der Startseite.
Use Case: Ein Shop mit mehreren Sources, hohem Bestelldurchsatz und vielen Teilversänden. Der Checkout «hängt» in der Zahlungsbestätigung, New Relic oder Slow-Query-Log zeigen Zugriffe auf inventory_reservation, nicht auf Catalog-Indexe. PHP-FPM ist nicht saturiert. Das ist ein Ledger-Problem, kein Theme-Problem.
Zwei Dinge werden oft verwechselt:
inventory_cleanup_reservations(Cron): löscht kompensierte Sequenzen, deren Menge summiert 0 ergibt – standardmässig täglich um Mitternacht, Zeitpunkt und Frequenz sind konfigurierbar. Adobe gruppiert nach Produkt und Entstehungstag; Sequenzen, die am selben Tag nicht vollständig kompensiert sind, bleiben stehen. Das ist korrekt, solange die Summe 0 ist, sobald die Order fertig ist – die Zeilen belasten aber weiterhin Inserts und Scans.inventory.reservations.cleanup(Message-Queue-Consumer): löscht Reservierungen pro SKU nach Produktlöschung. Nötig, wenn «Synchronize with Catalog» aktiv ist. Das ist nicht der Tabellen-Aufräumer für den Checkout.
Wer den Consumer startet und den Cron ignoriert (oder umgekehrt), räumt die falsche Arbeit weg.
Zuerst messen, nichts erfinden
Bevor ihr Cleanup anfasst, braucht ihr den Ist-Zustand eures Shops – nicht eine Zahl aus einem Blog.
- Tabellengrösse: In MySQL/MariaDB
SHOW TABLE STATUS LIKE 'inventory_reservation';und eine Zeilenzahl (SELECT COUNT(*)bzw. Schätzung aus Status). Notiert Data_length, Index_length, Rows. Das ist eure Baseline, kein Zielwert aus dem Netz. - Wachstum: Dieselbe Abfrage vor und nach dem Tagesgeschäft, plus nach dem Cleanup-Fenster. Wächst die Tabelle über Tage, obwohl Bestellungen in Endzustände laufen, kommt Cleanup nicht hinterher oder Kompensationen fehlen.
- Offene Holds: Summen pro SKU/Stock, die nicht 0 sind. Adobe: alle Reservierungen einer fertigen Order sollen 0 ergeben. Weicht das ab, ist das eine Inkonsistenz, kein «grosser Index».
- Consumer: Läuft
inventory.reservations.updateSalabilityStatus? Bei Katalog-Sync zusätzlichinventory.reservations.cleanup? Cron-Historie voninventory_cleanup_reservationsincron_schedule: last_success, Status missed/error. - Checkout-Pfad: Slow Query / APM auf Place-Order, nicht auf der Startseite. Wenn GraphQL-Cart und Place-Order dieselbe Tabelle treffen, seht ihr den Ledger zweimal – Cache hilft hier nicht, weil Reservierungen schreibend sind. Cachebar bleibt, was der GraphQL-Beitrag trennt: Stammdaten ja, Warenkorb und Session nein.
Keine Schwellenwerte aus fremden Shops übernehmen. «Die Tabelle ist zu gross» gilt erst, wenn eure Messung Grösse, Wachstum und Checkout-Queries zusammenbringt.
Cleanup und Cron sauber halten
Adobe: Der Cron findet vollständige Sequenzen mit Mengensumme 0 und löscht sie. Default ist täglich um Mitternacht. Bei vielen Bestellungen pro Tag kann das Fenster zu selten sein – das entscheidet ihr anhand des Wachstums, nicht anhand eines Rezepts.
Praktisch:
- Cron-Gruppe und Job in Magento prüfen, nicht nur crontab des Users.
- Nach einem Lauf Grösse erneut messen. Unveränderte Tabelle: Job läuft nicht, bricht ab, oder es gibt keine Sequenzen mit Summe 0 (dann sind Kompensationen das Thema, nicht Delete).
- Cleanup nicht während des Peak-Checkouts «mal schnell» als riesigen Delete anstossen, ohne Staging. Delete und Insert auf derselben InnoDB-Tabelle konkurrieren; das ist der Moment, in dem Checkout-Inserts warten.
- Bekannte Adobe-Hinweise zu fehlendem
object_idin der Metadata: Wenn der Cron nachweislich nicht räumt, den aktuellen Inventory-Stand und Release Notes prüfen, bevor ihr manuell löscht. Manuelles Delete nur für Zeilen, deren Summe je stock_id/sku wirklich 0 ist – und nur mit Backup plus Staging.
Inkonsistenzen listen, dann kompensieren
Wenn Holds nach Complete/Canceled/Closed nicht auf 0 stehen, hilft nicht mehr Cleanup, sondern Adobes CLI. Zwei Befehle, Dokumentation: Inventory Management CLI Reference.
bin/magento inventory:reservation:list-inconsistencies bin/magento inventory:reservation:create-compensations
Optionen, die ihr braucht:
-c/--complete-orders– fertige Orders, bei denen Holds hängen geblieben sind.-i/--incomplete-orders– offene oder teilweise gelieferte Orders, bei denen zu viel oder zu wenig reserviert ist.-r/--raw– maschinenlesbarINCREMENT_ID:SKU:MENGE:STOCK_ID.-b/--bunch-size– wie viele Orders pro Durchlauf geladen werden.
Zuerst listen, Ausgabe lesen, erst dann schreiben. Trocken: Liste nachvollziehen (SKU, Vorzeichen, Stock). Typische Ursachen laut Adobe: Upgrade mit offenen Orders ohne initiale Reservierung, «Manage Stock» nachträglich auf Ja, Stock einem Website neu zugeordnet, während Bestellungen liefen, Sources von Produkten mit offenen Orders entfernt.
Wenn die Rohdaten stimmen, pipe mit -r:
bin/magento inventory:reservation:list-inconsistencies -r | bin/magento inventory:reservation:create-compensations bin/magento inventory:reservation:list-inconsistencies -r -c | bin/magento inventory:reservation:create-compensations bin/magento inventory:reservation:list-inconsistencies -r -i | bin/magento inventory:reservation:create-compensations
SKUs mit Leerzeichen in Anführungszeichen. Danach dieselbe List-Command erneut: Ziel ist «No order inconsistencies were found.» Kompensationen sind zusätzliche Ledger-Zeilen, kein Update bestehender Rows. Cleanup darf sie später löschen, sobald die Summe 0 ist.
Nicht auf Production pipen, ohne Staging und ohne Backup der Tabelle. Create-compensations ändert verkaufbare Mengen.
Checkliste für den Betrieb
- Tabellenstatus und Zeilenzahl von
inventory_reservationdokumentieren (vorher). - Consumer
inventory.reservations.updateSalabilityStatusaktiv? Croninventory_cleanup_reservationszuletzt erfolgreich? - Checkout-Slow-Queries: treffen sie diese Tabelle beim Place-Order?
list-inconsistenciesohne Write, getrennt-cund-i.- Nur nach Review:
create-compensationsauf Staging, dann Production im Change-Fenster. - Cleanup laufen lassen bzw. Frequenz an das gemessene Wachstum anpassen.
- Danach erneut messen: Grösse, Inkonsistenzen, Checkout-Queries. Fertig ist nicht «Befehl gelaufen», sondern gleiche Messung wie in Schritt 1 plus leere Inconsistency-Liste für den betrachteten Scope.
Vorher / Nachher
Vorher: Die Tabelle wächst mit jeder Bestellung. Cleanup ist unsichtbar oder missed. Der Checkout schreibt in eine unaufgeräumte Tabelle. Verkaufbare Mengen und Source-Bestand passen optisch nicht, weil Holds nicht kompensiert sind. Niemand hat list-inconsistencies gelesen.
Nachher: Baseline steht. Consumer und Cron sind nachgewiesen. Fertige Orders kompensieren auf 0, Cleanup löscht Sequenzen mit Summe 0. Place-Order-Queries auf die Tabelle sind wieder unauffällig – gemessen an eurem APM, nicht an einer Prozentangabe. GraphQL bleibt getrennt: cachebare Produktdaten cachebar, Reservierungsschreibzugriff nicht.
Kennzahl für den Betrieb: dokumentierte Tabellengrösse plus Inconsistency-Report plus erfolgreicher Cleanup-Lauf – vor und nach dem Change. Ohne diese drei Werte ist das Ticket nicht zu.
Fünf Schritte zur Entscheidung
- Ist MSI aktiv und Place-Order langsam, während Catalog-Seiten passen? Dann Ledger prüfen, nicht zuerst den Full-Page-Cache.
- Wächst
inventory_reservationtrotz Endzustand der Orders? Dann Cron und Kompensationen, nicht mehr Hardware. - Zeigt
list-inconsistenciesfertige Orders? Dann kompensieren, nicht nur löschen. - Läuft der Salability-Consumer? Sonst lügen Storefront-Bestände unabhängig von der Tabellengrösse.
- Ist nach Cleanup und Kompensation dieselbe Messung wiederholt? Erst dann Production als erledigt führen.
Reservierungen sind der korrekte MSI-Mechanismus gegen Overselling. Sie werden zum Checkout-Problem, wenn das Ledger nicht geschlossen und nicht gelöscht wird. Messen, Consumer und Cron nachweisen, Inkonsistenzen listen, kompensieren, erneut messen.
Wenn ihr unsicher seid, ob eure Magento- oder Adobe-Commerce-Production die Tabelle, die Consumers und die Inconsistency-CLI im Griff hat, prüfen wir Baseline, Cleanup und Kompensationen mit euch – über die Leistungsseite zu Magento 2, Server und Betrieb.





