← Alle Beiträge

Shopware 6: „SAVEPOINT DOCTRINE_2 does not exist“ beim Speichern der Cache-Invalidation-Tags

Shopware 6: „SAVEPOINT DOCTRINE_2 does not exist“ beim Speichern der Cache-Invalidation-Tags

Im Log einer Shopware-6.7-Installation steht ab und zu ein Eintrag mit dem Level ERROR, der nach kaputter Datenbank klingt: Ein Savepoint mit dem Namen DOCTRINE_2 soll nicht existieren. Niemand hat einen Savepoint angelegt, im Shop fällt nichts auf, und nach ein paar Tagen ist der Eintrag wieder da. Manchmal taucht dieselbe Meldung auch ohne den Cache-Teil auf, im Message-Worker oder als Uncaught PHP Exception in einem Request, dann mit Nummern wie DOCTRINE_4 oder DOCTRINE_749.

Die Fehlermeldung

app.ERROR: Failed to store cache invalidation tags, invalidating immediately.
Error: An exception occurred while executing a query: SQLSTATE[42000]:
Syntax error or access violation: 1305 SAVEPOINT DOCTRINE_2 does not exist

Varianten derselben Ursache:

request.CRITICAL: Uncaught PHP Exception Doctrine\DBAL\Exception\DriverException:
"An exception occurred while executing a query: SQLSTATE[42000]: Syntax error or
access violation: 1305 SAVEPOINT DOCTRINE_749 does not exist"
at ExceptionConverter.php line 102

console.CRITICAL: Error thrown while running command "messenger:consume ...".
Message: "An exception occurred while executing a query: SQLSTATE[42000]:
Syntax error or access violation: 1305 SAVEPOINT DOCTRINE_4 does not exist"

Was dahintersteckt

Doctrine DBAL kennt keine echten verschachtelten Transaktionen. Startet Code eine Transaktion, während schon eine offen ist, legt DBAL stattdessen einen Savepoint an. Der Name ist einfach DOCTRINE_ plus die aktuelle Verschachtelungstiefe (_getNestedTransactionSavePointName() in Doctrine\DBAL\Connection). DOCTRINE_2 heißt also: Das war die zweite Ebene, außen herum lief bereits eine Transaktion.

Jetzt kommt MySQL ins Spiel. Erkennt InnoDB einen Deadlock, rollt es die komplette Transaktion des Opfers zurück, nicht nur das letzte Statement. Damit sind auch alle Savepoints weg. DBAL weiß davon nichts, versucht im Fehlerfall brav ROLLBACK TO SAVEPOINT DOCTRINE_2 und bekommt Fehler 1305 zurück. Diese zweite Exception überdeckt die erste: Im Log steht der Savepoint, der eigentliche Deadlock ist verschwunden. Das Problem ist bei Doctrine als doctrine/dbal#6651 bekannt und noch offen.

Dazu kommt ein Nebeneffekt. Schlägt das Zurückrollen auf den Savepoint fehl, zählt DBAL die Verschachtelungstiefe nicht herunter (rollBack() in DBAL 4.4). Die Verbindung glaubt danach, noch in einer Transaktion zu stecken, obwohl die Datenbank keine mehr offen hat. Jede weitere Transaktion in diesem PHP-Prozess legt dann einen Savepoint in einer Transaktion an, die es nicht gibt, und scheitert beim Commit wieder mit 1305. In einem lang laufenden Worker kann der Zähler so immer weiter steigen. Daher kommen Nummern wie DOCTRINE_749.

Und warum ausgerechnet die Cache-Invalidierung? Seit 6.7 invalidiert Shopware Cache-Tags standardmäßig verzögert. Bei jeder Änderung an Produkten, Kategorien und Co. schreibt der CacheInvalidator die betroffenen Tags erst in die Tabelle invalidation_tags, ein Scheduled Task räumt sie später ab. Speicher ist per Default mysql (shopware.cache.invalidation.delay_options.storage). Der MySQLInvalidatorStorage schreibt diese Tags in einer eigenen Transaktion mit READ COMMITTED. Bei vielen parallelen Schreibzugriffen laufen sich diese Inserts gegenseitig in die Quere. Die offizielle Doku sagt dazu ziemlich deutlich, dass Deadlocks auf dieser Tabelle unter Last „inevitable“ sind, und empfiehlt Redis.

Seit 6.7.6.0 fängt der CacheInvalidator jeden Fehler beim Speichern ab, loggt genau die Meldung oben und leert die betroffenen Cache-Einträge stattdessen sofort. Vorher ist die Exception ungefangen nach oben durchgereicht worden.

Ist das harmlos?

Für den Cache ja. „Invalidating immediately“ ist korrekt: Die Seiten werden sofort statt ein paar Minuten später neu gebaut. Das kostet ein paar Cache-Misses mehr, mehr nicht.

Für die Datenbankverbindung nicht unbedingt. Shopware hat in PR #15332 („fix: broken transaction level on cache storage deadlock“) genau diesen Fall beschrieben: Nach einem Deadlock im Invalidator-Storage stimmte die Verschachtelungstiefe nicht mehr, und die nächste Transaktion im selben Request (im Beispiel der CategoryIndexer) scheiterte mit dem Savepoint-Fehler. Der Fix verwendet seitdem RetryableTransaction::transactional(), das die Verbindung nach einem Fehler wieder auf Tiefe 0 setzt. Er ist ab Shopware 6.7.9.0 enthalten.

Der Haken: Diese Reparatur greift nur, wenn der Speichervorgang selbst die äußerste Transaktion war. Läuft er verschachtelt, und DOCTRINE_2 in deiner Meldung sagt genau das, wird die Exception unverändert weitergeworfen und vom CacheInvalidator geschluckt. Die äußere Transaktion hat MySQL in diesem Moment schon komplett zurückgerollt. Was der aufrufende Code danach daraus macht, hängt von diesem Code ab. Das habe ich aus dem Quelltext abgeleitet, nicht in einem Shop nachgestellt. Wenn du neben der Cache-Meldung auch Savepoint-Fehler aus Requests oder dem Worker siehst, ist das der Hinweis, dass es nicht beim Cache geblieben ist.

Prüfen, ob es wirklich das ist

Zuerst Version und Storage:

bin/console --version
bin/console debug:config shopware cache.invalidation

Steht dort storage: mysql, bist du im beschriebenen Pfad. Den verdeckten Deadlock findest du in den Logs nicht, aber MySQL merkt sich den letzten:

SHOW ENGINE INNODB STATUS\G

Im Abschnitt LATEST DETECTED DEADLOCK steht, welche Statements beteiligt waren. Taucht dort invalidation_tags auf, hast du den Schuldigen. Steht dort eine ganz andere Tabelle, etwa aus einem Plugin, liegt der Deadlock woanders, und der Cache-Eintrag ist nur der Ort, an dem es zufällig zuerst geknallt hat.

Ein Blick auf den Rückstau schadet auch nicht:

SELECT COUNT(*) FROM invalidation_tags;

Wächst die Zahl dauerhaft, läuft der Scheduled Task shopware.invalidate_cache nicht oder zu selten, und die Tabelle wird zum Engpass.

Die Lösung

Der eigentliche Fix ist, die Tags gar nicht mehr in MySQL zu speichern. Wenn du Redis ohnehin betreibst, stell den Storage um:

# config/packages/prod/shopware.yaml
shopware:
    redis:
        connections:
            ephemeral:
                dsn: '%env(REDIS_EPHEMERAL)%'
    cache:
        invalidation:
            delay_options:
                storage: redis
                connection: 'ephemeral'

Danach bin/console cache:clear und die Worker neu starten. Die Verbindungsnamen sind frei wählbar, die Doku zu Redis-Verbindungen und zu den Performance-Tweaks beschreibt beides. Damit verschwindet der Insert in invalidation_tags aus deinen Transaktionen, und mit ihm diese Deadlock-Quelle.

Zusätzlich solltest du mindestens auf 6.7.9.0 sein, damit ein Deadlock im Storage nicht mehr die ganze Verbindung für den Rest des Requests vergiftet.

Ohne Redis bleibt dir nur Schadensbegrenzung, also ein Workaround und kein Fix: Worker mit --time-limit und --memory-limit laufen lassen, damit ein Prozess mit verkorkster Verbindung nicht ewig weiterlebt, und den Scheduled Task im Auge behalten. Die Meldung wird dann weiter auftauchen, nur seltener schaden.

Wenn die Meldung ohne Cache-Kontext kommt

SAVEPOINT DOCTRINE_x does not exist ist immer ein Folgefehler. Im Worker (messenger:consume) bedeutet eine hohe Nummer meist, dass die Verbindung in diesem Prozess schon vorher kaputtgegangen ist, und jede weitere Transaktion fällt um, bis der Worker neu startet. Kommt die Meldung aus dem Logkanal eines Plugins, hat dessen Code eine Transaktion offen gehabt, als irgendwo darin ein Deadlock passiert ist. In allen Fällen gilt: SHOW ENGINE INNODB STATUS direkt nach dem Auftreten lesen. Die beteiligten Tabellen sagen dir, ob du bei Shopware, bei einem Plugin oder bei deiner eigenen Anpassung suchen musst.

Der Shop läuft bei diesem Fehler weiter, deshalb bemerkt ihn meist erst jemand, der zufällig ins Log schaut. ShopSignal liest die Log-Fehler deines Shopware-6-Shops für dich mit und zeigt dir außerdem, wie viele Nachrichten in der Message Queue fehlgeschlagen sind. Tauchen neben der Cache-Meldung plötzlich Savepoint-Fehler aus dem Worker auf, siehst du das dort, bevor sich die Queue stapelt.