Zum Hauptinhalt springen
Wenn Sie Update-Konflikte auf Zielzeilen steuern möchten, ohne Fremdschlüsselprüfungen zu blockieren, verwenden Sie lockForNoKeyUpdate. Diese Methode wurde dem Query Builder von Laravel 13.x hinzugefügt und erzeugt für PostgreSQL FOR NO KEY UPDATE.
Diese Seite basiert auf der Implementierung von Laravel Framework 13.x. Prüfen Sie, ob die Funktion aus dem Branch 13.x in der von Ihnen verwendeten Release enthalten ist.

Unterschied zu lockForUpdate

Die offizielle Laravel-Dokumentation beschreibt pessimistisches Sperren mit sharedLock und lockForUpdate. lockForNoKeyUpdate fügt einen weiteren Sperrmodus hinzu, der über die gemeinsame API des Query Builders ausgewählt werden kann. FOR NO KEY UPDATE bedeutet nicht, dass alle Operationen ohne Blockierung ablaufen. Verwenden Sie es nur, wenn die schwächere Update-Sperre angemessen ist, und prüfen Sie die Transaktionsgrenzen und das Sperrverhalten der Datenbank, die Sie tatsächlich einsetzen.

Innerhalb einer Transaktion verwenden

Erwerben Sie die pessimistische Sperre und führen Sie das Update in derselben Transaktion aus. Im folgenden Beispiel bleibt die Benutzerzeile gesperrt, während die Aktualisierung des Guthabens vorbereitet und geschrieben wird.
Wie die offizielle Dokumentation es für lockForUpdate empfiehlt, bleiben die abgerufenen Daten durch das Einschließen in eine Transaktion geschützt, bis die Operation abgeschlossen ist. DB::transaction committet, wenn der Callback normal zurückkehrt, und führt ein Rollback aus, wenn der Callback eine Exception wirft. lockForNoKeyUpdate fügt der select-Abfrage nur eine Sperrklausel hinzu. Es führt weder automatisch ein Update aus noch deaktiviert es Fremdschlüssel-Constraints.

Erzeugtes SQL je Datenbank

Der Query Builder fragt die Grammar der Verbindung nach dem Sperrwert. In der Implementierung von Laravel Framework 13.x gibt nur die PostgreSQL-Grammar for no key update zurück. Eine PostgreSQL-Verbindung erzeugt zum Beispiel folgendes SQL. Bindings funktionieren wie bei jeder anderen Query-Builder-Abfrage.
Der Aufruf von lockForNoKeyUpdate auf einer Nicht-PostgreSQL-Verbindung schlägt selbst nicht fehl. Er hat jedoch nicht dieselbe Bedeutung wie FOR NO KEY UPDATE in PostgreSQL: MySQL und SQL Server kompilieren ihn zu ihrer normalen Update-Sperre, während SQLite keine Sperrklausel ausgibt.

Interne Verarbeitung im Framework

Die Methode überlässt die Wahl der Sperre der Grammar der Verbindung, statt im Query Builder nach Datenbanktreibern zu verzweigen.
  1. Builder::lockForNoKeyUpdate() ruft grammar->getNoKeyUpdateLock() auf.
  2. Die Basisklasse Grammar gibt true zurück, was den Fallback auf die normale Update-Sperre darstellt.
  3. PostgresGrammar gibt den String for no key update zurück.
  4. compileLock übernimmt String-Werte unverändert; jede Grammar entscheidet selbst, wie sie den booleschen Fallback kompiliert.
So muss Anwendungscode kein datenbankspezifisches SQL enthalten. Gleichzeitig hängt die Bedeutung der Sperre von der Datenbank ab, daher darf Code, der mehrere Treiber unterstützt, kein PostgreSQL-spezifisches Verhalten voraussetzen.

Von bestehenden pessimistischen Sperren migrieren

Wenn Sie einen bestehenden Aufruf von lockForUpdate ersetzen, ändern Sie nicht nur den Methodennamen. Prüfen Sie Folgendes:
  • Die Operation benötigt wirklich eine Sperre, die Fremdschlüsselprüfungen nicht blockiert.
  • Die Produktionsverbindung verwendet PostgreSQL.
  • Der Fallback auf eine normale Update-Sperre ist unter MySQL oder SQL Server akzeptabel.
  • Erwerb der Sperre, Update und Commit erfolgen in einer Transaktion.
  • Die Reihenfolge, in der bestehende Sperren auf mehrere Zeilen erworben werden, bleibt konsistent.
Wenn ein Paket diese API verwendet, setzen Sie entweder eine Laravel-Version voraus, die die Methode enthält, oder entwerfen Sie einen expliziten Fallback für ältere Versionen. Eine reine method_exists-Prüfung kann eine Bedeutungsänderung verbergen: Ein Benutzer erwartet vielleicht das PostgreSQL-Verhalten, während ein anderer Treiber eine normale FOR UPDATE-Sperre ausführt.

Verwendete Primärquellen

Zuletzt geändert am 21. November 2026