Logo run_as_root - Magento B2B Agentur Würzburg
PERFORMANCE

Magento 2 Session Locking abschalten: disable_locking=1 gegen langsamen Checkout

Magentos Redis-Session-Handler serialisiert parallele AJAX-Requests desselben Kunden per Lock. Wann disable_locking=1 in app/etc/env.php dein Frontend spürbar schneller macht.


On this page

    Eingeloggter Kunde, Produktseite, Klick auf "in den Warenkorb". Der Mini-Cart-Spinner dreht vier Sekunden lang. Die Datenbank ist nicht überlastet. Redis ist nicht langsam. PHP hat freie Worker übrig. Der Mini-Cart-Refresh steht einfach in der Schlange hinter dem Add-to-Cart-Write, serialisiert durch einen Session-Lock, von dem im Team längst keiner mehr weiß, dass er aktiv ist.

    Wenn du von Varnish-Hit-Rate unter 30 % bei Magento 2 diagnostizieren hierher gekommen bist: dieser Spinner ist die andere Hälfte desselben Problems. Ein Config-Flip, der zehn Sekunden dauert, aber auf vielen Shops seit fünf Jahren ungefixt herumliegt, weil nach dem initialen Setup niemand mehr die Session-Handler-Doku aufschlägt. Die Defaults sind auf eine Magento-Welt getunt, die es 2026 nicht mehr gibt.

    TL;DR

    • Magentos Redis-Session-Handler läuft standardmäßig mit disable_locking=0 und serialisiert damit parallele Requests derselben Session über einen Lock auf Redis-Ebene.
    • break_after_frontend=5 bedeutet: jeder Request, der den Lock nicht bekommt, wartet bis zu fünf Sekunden, bevor er aufgibt. Ein einzelner Kunde mit drei gleichzeitigen AJAX-Calls kann sich damit selbst hinter seinen eigenen vorherigen Request stellen.
    • Auf einem Varnish-gefronteten Storefront fasst cachebarer Gast-Traffic die Session so gut wie nie an. Dort bringt der Lock nichts, er bremst nur die Requests, die die Session wirklich brauchen.
    • Setz disable_locking=1 in app/etc/env.php. Auf einem Shop, der jahrelang mit den Defaults lief, sinkt die p95-TTFB bei eingeloggten Interaktionen spürbar. Im Trace kollabiert der redis-session-read-Span von Sekunden auf Millisekunden.
    • Der eine Fall, der dagegen spricht: ein Modul, das die Session als Serialisierungs-Queue missbraucht. Dieses Muster ist selten, fast immer falsch, und in fünf Minuten Grep aufgespürt.

    Was break_after_frontend=5 wirklich macht

    Magento nutzt Colin Mollenhours php-redis-session-abstract als Redis-Session-Backend. Sobald ein Request die Session liest, holt sich der Handler einen Lock auf Redis-Ebene, geschlüsselt auf die Session-ID. Der Lock hat eine TTL (max_lifetime, 60 Sekunden im Default), damit er nicht ewig hängen bleibt, falls PHP mitten im Request abstürzt.

    Trifft während dieser Zeit ein zweiter Request für dieselbe Session ein, landet er in einer Wartschleife. break_after_frontend ist genau dieses Wartebudget in Sekunden, gültig für Storefront-Requests (nicht Admin). Der Default liegt bei 5. Der zweite Request prüft den Lock, schläft kurz, prüft wieder, bis der Lock entweder frei wird oder das Budget aufgebraucht ist.

    Zwei weitere Werte, die dir in app/etc/env.php auffallen sollten:

    • bot_first_lifetime und bot_lifetime steuern, wie lange Sessions für User-Agents leben, die zum Bot-Muster passen. Halt die kurz. Eine Bot-Session, die lange rumliegt, ist ein Redis-Key, der dir Speicher kostet, ohne irgendwas zurückzugeben.
    • max_concurrency deckelt, wie viele Requests gleichzeitig in der Wartschleife hängen dürfen. Default: 6. Hämmert ein Bot oder ein fehlkonfiguriertes Script auf eine einzelne Session ein, verhindert dieser Wert, dass er dir sämtliche php-fpm-Worker blockiert.

    Keiner dieser beiden Werte löst das eigentliche Problem. break_after_frontend=5 ist auf einem Storefront von heute eine selbstgebaute Fünf-Sekunden-Obergrenze für die Hälfte deiner dynamischen Seitenaufrufe.

    Warum sich ein einzelner Kunde selbst ausbremst

    Schau dir an, was passiert, wenn ein eingeloggter Kunde auf einem modernen Magento-2-Storefront eine Produktseite lädt.

    Das HTML kommt schnell aus Varnish. Danach feuert der Browser vier, fünf fast zeitgleiche Requests ab, um die personalisierten Teile nachzuladen: /customer/section/load/?sections=cart,messages,customer,directory-data für Mini-Cart und Begrüßung, /rest/V1/carts/mine, falls ein Drittanbieter-Plugin die Warenkorbdaten braucht, vielleicht noch ein eigener REST-Endpoint für ein Promo-Banner, ein Form-Key-Refresh, oder ein Tracking-Pixel einer Ad-Plattform, das am Ende auch einen PHP-Endpoint anstößt.

    Jeder dieser Requests trägt dasselbe Session-Cookie. Jeder will wissen, wer der Kunde ist, also muss er die Session lesen. Mit den Defaults schnappt sich der erste Request den Lock, die anderen drei warten. Braucht der erste Request 400 ms zum Rendern, hängt der zweite diese 400 ms komplett untätig in der Wartschleife, bevor er drankommt. Dauert der erste länger, etwa weil ein Catalog-Observer träge ist oder ein Payment-Plugin eine externe API anspricht, wartet der zweite entsprechend länger mit.

    Für keinen dieser Requests wäre Serialisierung eigentlich nötig. Jeder liest die Session nur, oder schreibt höchstens einen Teil, der mit den anderen nicht kollidiert. Der Lock weiß das aber nicht, er ist von Haus aus pessimistisch.

    Auf einem Shop, an dem wir kürzlich gearbeitet haben, zeigte ein Production-Blackfire-Trace den Span Cm_RedisSession_Model_Session::read() bei rund zweieinhalb Sekunden auf einem Mini-Cart-Request. Der Kunde hatte gerade auf einer Produktseite "in den Warenkorb" geklickt, die übliche AJAX-Kaskade lief los, und der Mini-Cart-Refresh wartete am Ende einfach auf den Abschluss des Add-to-Cart-Writes. Datenbank im Leerlauf. Redis im Leerlauf. PHP im Leerlauf. Die Wartschleife wartete, sonst nichts.

    ⚠️
    Der Fehler, den fast alle machen: sie sehen diesen Trace und schieben es auf Redis. Redis hat damit nichts zu tun. Redis ist ein Key-Value-Store mit Mikrosekunden-Latenz, der exakt das tut, was er soll. Der Flaschenhals ist der Applikations-Lock oben drauf, und der sitzt in PHP, nicht in Redis.

    Warum Shops mit Full Page Cache bedenkenlos umschalten können

    Das klassische Argument für Session Locking sind Race Conditions. Schreiben zwei Requests derselben Session gleichzeitig in $_SESSION, gewinnt der letzte Writer, und Daten gehen verloren. Der Lock verhindert genau das.

    2015 war dieses Argument stärker als heute. Zwei Dinge haben sich seitdem geändert.

    Erstens hält Magentos AJAX-Personalisierungsschicht (section_data_provider, customer-data.js) die serverseitige Session bewusst schlank. Der schwere Teil des States, also Warenkorbinhalt, Kundenbegrüßung, Messages, läuft über REST-Endpoints, die nicht auf einen blockierenden Session-Write-Pfad angewiesen sind. Auf einem einigermaßen unangetasteten Magento-2-Build schreiben parallele AJAX-Requests gegen dieselbe Session nur selten in denselben Key.

    Zweitens sorgt Full Page Cache (Varnish, Fastly, Cloudflare FPC) dafür, dass Gast-Traffic die Session meistens komplett umgeht. Der Request landet bei Varnish, trifft ein gecachtes Objekt und ist fertig, ohne PHP je zu erreichen. Der Session-Handler kommt hier gar nicht ins Spiel. Lock-Contention gibt es also nur bei dynamischen Requests, und das ist überwiegend genau die Gleicher-Kunde-AJAX-Kaskade von oben, die von Locking nicht profitiert.

    Die eigentliche Behauptung, für die wir hier geradestehen: Verursacht ein Concurrent-Write-Race in einer Storefront-Session bei dir einen Bug, ist Locking nicht der richtige Fix. Der richtige Fix ist, den Code zu finden, der aus zwei gleichzeitigen Requests denselben Session-Key beschreibt, und ihn so umzubauen, dass er das nicht mehr tut, meistens indem der State komplett aus der Session wandert. In der Praxis sind die einzigen Fälle, in denen Locking tatsächlich einen Bug verhindern würde, Custom-Module, die die Session wie eine Queue oder einen Zähler behandeln. Diese Module sind kaputt, mit oder ohne Lock.

    Die Änderung, in einer Zeile

    Öffne app/etc/env.php. Suche den session-Block, meist sieht er so aus:

    1'session' => [
    2 'save' => 'redis',
    3 'redis' => [
    4 'host' => '127.0.0.1',
    5 'port' => '6379',
    6 'database' => '3',
    7 'password' => '',
    8 'timeout' => '2.5',
    9 'persistent_identifier' => '',
    10 'compression_threshold' => '2048',
    11 'compression_library' => 'gzip',
    12 'log_level' => '1',
    13 'max_concurrency' => '6',
    14 'break_after_frontend' => '5',
    15 'break_after_adminhtml' => '30',
    16 'first_lifetime' => '600',
    17 'bot_first_lifetime' => '60',
    18 'bot_lifetime' => '7200',
    19 'disable_locking' => '0',
    20 'min_lifetime' => '60',
    21 'max_lifetime' => '2592000',
    22 ],
    23],

    Stell disable_locking von '0' auf '1'. Config-Cache leeren (bin/magento cache:flush config), php-fpm neu starten, damit die laufenden Worker die neue Config übernehmen, fertig. Keine Datenbankänderung, kein Code-Deploy, keine Migration nötig.

    Session Locking im Admin-Bereich (break_after_adminhtml=30) ist ein anderes Thema. Im Adminpanel gibt es deutlich mehr Concurrent-Write-Contention als im Storefront, weil Admin-Sessions Permission-State, Store-Scope-State und Grid-Filter mitschleppen, auf die mehrere offene Tabs munter gleichzeitig zugreifen. Lass das Locking für adminhtml an, außer du weißt genau, was deine Admins auf dem Shop treiben.

    Vorher und nachher messen

    Roll diese Änderung nicht aus, ohne sie zu messen. Ohne Zahl änderst du nur eine Config, nicht das Verhalten deines Shops.

    Am günstigsten kommst du an einen Production-Trace mit Blackfire oder Tideways entlang eines eingeloggten Kunden-Klickpfads. Konkret: Produktseite laden, in den Warenkorb legen, den Mini-Cart-Refresh im Wasserfall beobachten. Vor dem Flip ist der Session-Read-Span beim Mini-Cart-Request lang und hängt grob mit der Dauer des Add-to-Cart-Requests zusammen. Nach dem Flip fällt dieser Span auf einstellige Millisekunden. Passiert das nicht, ist der Session-Handler auf diesem Pfad gar nicht der Flaschenhals, und die Config-Änderung wird dir hier nicht weiterhelfen.

    Hast du weder Blackfire noch Tideways zur Hand, kommst du mit XHProf auf einer Staging-Umgebung gegen eine geskriptete, eingeloggte AJAX-Kaskade (ab oder hey mit Session-Cookie, parallel gegen /customer/section/load/ und eine Add-to-Cart-URL) nah genug ran. Vergleich die p95-Antwortzeit des langsameren Requests über zehn Durchläufe, vorher und nachher. Das Delta ist deine Antwort.

    Fürs Production-Monitoring: behalt die "PHP time"-Metrik für den customer/section/load-Endpoint in New Relic oder Datadog im Blick. Der liefert das zuverlässigste Frühwarnsignal für Session-Contention, weil er auf jeder Seite für eingeloggte Kunden läuft und dabei meistens die Session anfasst.

    Wann du die Finger davon lassen solltest

    Es gibt genau ein Szenario, in dem disable_locking=1 die falsche Entscheidung ist: ein Modul auf deinem Shop nutzt die Session als Queue oder Serialisierungs-Primitive. Das Muster sieht so aus: das Modul liest einen Zähler aus der Session, erhöht ihn, schreibt ihn zurück und verlässt sich darauf, dass der Lock dieses Read-Modify-Write atomar macht. Ohne Lock lesen zwei parallele Requests denselben Wert, beide erhöhen ihn, beide schreiben denselben erhöhten Wert zurück, und ein Increment geht verloren.

    Dieses Muster ist auf Magento 2 selten. Es ist außerdem immer falsch. Findest du es, fix das Modul, statt den Lock als Pflaster darüberzukleben. Ein Grep-Durchlauf fördert die meisten Übeltäter schnell zutage:

    1grep -rn --include='*.php' -E '\$this->(checkoutSession|customerSession|session)->\w+\(.*\+' app/code/
    2grep -rn --include='*.php' 'setSession' app/code/ | grep -v Test

    Der andere seltene Fall ist ein Custom-Checkout-Schritt, der sich ausdrücklich auf sequenzielle Session-Writes verlässt (selten, aber wir haben das schon einmal in einem Loyalty-Points-Modul gesehen). Hat dein Shop so etwas, merkst du es sofort, weil das Deaktivieren des Locks im Test einen kundenrelevanten Bug auslöst. Das ist das Signal, den Lock wieder zu aktivieren, nicht das Signal, ihn dauerhaft als Generalpflaster zu belassen.

    ⚠️
    Schaltest du den Lock aus und eine Testbestellung scheitert, dann schalt den Lock nicht einfach wieder ein und geh zur Tagesordnung über. Das Modul, das den Fehler verursacht, ist unabhängig von der Lock-Semantik kaputt, der Lock hat den Bug nur überdeckt. Fix das Modul.

    Weiterführende Artikel

    Die Redis-Session-Locking-Checkliste

    1. Aktuelle Session-Config lesen

      Öffne app/etc/env.php und such den Block session.redis. Notier die aktuellen Werte von disable_locking, break_after_frontend, break_after_adminhtml und max_concurrency. Die Baseline muss schriftlich feststehen, bevor du irgendwas änderst.

    2. Prüfen, ob Varnish den Gast-Traffic wirklich fronted

      curl -sI auf die Startseite. Cache-Control sollte public sein mit einer max-age über null, Age sollte bei Wiederholung steigen. Landet Gast-HTML bei jedem Request direkt bei PHP, fix das zuerst. disable_locking=1 ohne FPC davor ist eine deutlich riskantere Änderung.

    3. Vorher-Trace auf einem eingeloggten Pfad aufnehmen

      Blackfire- oder Tideways-Trace von "PDP laden, in den Warenkorb klicken" im eingeloggten Zustand. Halt die Zeit von Cm_RedisSession_Model_Session::read und die Gesamtdauer der AJAX-Kaskade fest.

    4. Nach Session-als-Queue-Anti-Patterns greppen

      grep -rn --include='*.php' -E '\$this->(checkoutSession|customerSession|session)->\w+\(.*\+' app/code/. Jeder Treffer, der einen in der Session gespeicherten Zähler erhöht, ist ein Risiko. Sieh ihn dir an. Die meisten Treffer sind harmlos, die problematischen fallen schnell auf.

    5. disable_locking auf 1 setzen

      app/etc/env.php bearbeiten, 'disable_locking' => '0' auf 'disable_locking' => '1' ändern. break_after_adminhtml unangetastet lassen. bin/magento cache:flush config ausführen und php-fpm neu starten, damit die Worker die neue Config laden.

    6. Denselben Pfad erneut tracen

      Derselbe Blackfire-/Tideways-Trace wie in Schritt 3. Der Session-Read-Span sollte von Sekunden auf einstellige Millisekunden fallen. Die Gesamtdauer der AJAX-Kaskade sollte um genau das sinken, was die Wartezeit vorher gekostet hat.

    7. Production 24 Stunden beobachten

      Behalt customer/section/load und die Mini-Cart-REST-Endpoints in New Relic oder Datadog im Blick. Bestellrate und Checkout-Conversion sollten stabil bleiben oder besser werden. Die Fehlerrate darf sich nicht verändern.

    8. Die Änderung dokumentieren

      Committ env.php mit einer Commit-Message, die das Warum erklärt. Dein zukünftiges Ich, oder der nächste Entwickler an diesem Shop, will wissen, dass disable_locking=1 eine bewusste Entscheidung war und kein versehentlich überschriebener Default.

    Session-Contention ist selten das einzige Problem, das einen Shop bremst

    Wir führen fokussierte Magento-2-Performance-Audits durch. Du bekommst eine Blackfire-Baseline, die konkreten Config- und Code-Änderungen mit dem größten Hebel und eine Prioritätenliste. Zwei bis drei Tage, direkt am Code, ohne 80-seitiges PDF.

    Performance-Audit buchen

    Related articles

    01
    Security

    Cloudflare-WAF bei Magento 2: Warum "Protected" nicht gleich sicher heißt

    Ein grünes Cloudflare-Dashboard schützt deinen Magento-2-Shop nicht automatisch. Der Neun-Punkte-Check zu OWASP-Regeln, UA-Bypässen, Admin-Pfaden und TLS.

    von david-lambauer
    Apr 21, 2026
    02
    Security

    Subdomain-Takeover bei Magento: wenn vergessene CNAMEs zur Sicherheitslücke werden

    Nach dem Hosting-Wechsel weg von Hypernode oder Hipex bleiben CNAME-Einträge in deiner DNS-Zone liegen. Wie daraus ein Subdomain-Takeover wird und wie du deine Zone selbst prüfst.

    von david-lambauer
    Apr 21, 2026
    03
    Performance

    Magento 2: Niedrige Varnish-Hit-Rate diagnostizieren und fixen

    Hit-Rate unter 30 %? So findest du den PHP-Code, die Cookies und die Fehlkonfiguration, die Magento am Full Page Cache vorbeischleusen, Schritt für Schritt.

    von david-lambauer
    Apr 21, 2026