← Alle Beiträge

Shopware 6: „The JSON payload is malformed.“ im JsonRequestTransformerListener finden und einordnen

Shopware 6: „The JSON payload is malformed.“ im JsonRequestTransformerListener finden und einordnen

Im Log deines Shops stehen zwei Einträge kurz hintereinander, beide mit derselben Uhrzeit, beide mit „The JSON payload is malformed.“. Im Shop selbst merkst du nichts. Kein Kunde beschwert sich, der Checkout läuft. Trotzdem tauchen die Zeilen immer wieder auf, manchmal einzeln, manchmal in Schüben.

Die gute Nachricht vorweg: Das ist fast nie ein Fehler in deinem Shop. Es ist ein Fehler in einer Anfrage, die jemand an deinen Shop geschickt hat. Die Frage ist nur, wer.

Die Fehlermeldung

request.ERROR: Uncaught PHP Exception Symfony\Component\HttpKernel\Exception\BadRequestHttpException:
"The JSON payload is malformed." at JsonRequestTransformerListener.php line 31
{"exception":"[object] (Symfony\\Component\\HttpKernel\\Exception\\BadRequestHttpException(code: 0):
The JSON payload is malformed. at .../vendor/shopware/core/Framework/Api/EventListener/JsonRequestTransformerListener.php:31)"}

request.ERROR: Exception thrown when handling an exception
(Symfony\Component\HttpKernel\Exception\BadRequestHttpException: The JSON payload is malformed.
at JsonRequestTransformerListener.php line 31)

Die Zeilennummer hängt von der Shopware-Version ab. In 6.6 und 6.7 ist es Zeile 31, in älteren Versionen sieht die Datei anders aus.

Was dahintersteckt

Der JsonRequestTransformerListener liegt in src/Core/Framework/Api/EventListener/ und hat genau eine Aufgabe: Kommt eine Anfrage mit JSON-Body rein, dekodiert er den Body und legt die Daten in $request->request ab, damit Controller sie wie normale POST-Parameter lesen können. In der aktuellen Fassung sieht das so aus:

if (str_starts_with($event->getRequest()->headers->get('Content-Type', ''), 'application/json') && $event->getRequest()->getContent()) {
    try {
        $data = json_decode($event->getRequest()->getContent(), true, flags: \JSON_THROW_ON_ERROR);
    } catch (\JsonException) {
        throw new BadRequestHttpException('The JSON payload is malformed.');
    }

    $event->getRequest()->request->replace(\is_array($data) ? $data : []);
}

Zwei Bedingungen müssen also zusammenkommen. Der Header Content-Type beginnt mit application/json, und der Body ist nicht leer. Lässt sich dieser Body dann nicht als JSON lesen, gibt es eine 400 mit genau dieser Meldung. Ein leerer Body löst nichts aus, ein Formular-POST mit application/x-www-form-urlencoded auch nicht.

Wichtig für die Suche nach dem Absender: Der Listener hängt mit Priorität 128 am kernel.request-Event. Symfonys RouterListener, der die Route auflöst, läuft erst mit Priorität 32. Der JSON-Check passiert also, bevor Shopware überhaupt weiß, welche Route gemeint ist. Deshalb kann die Meldung auf jeder beliebigen URL entstehen, auch auf einer, die es im Shop gar nicht gibt. Admin-API, Store-API, Storefront, ein erfundener Pfad: egal.

Warum zwei Log-Einträge pro Anfrage

Die zweite Zeile („Exception thrown when handling an exception“) ist keine zweite Anfrage. Sie kommt aus Symfonys ErrorListener. Der baut für die Fehlerseite per $request->duplicate() eine Sub-Request, und die enthält weiterhin denselben Header und denselben kaputten Body. Die Sub-Request läuft wieder durch kernel.request, der JsonRequestTransformerListener schlägt ein zweites Mal an, und Symfony protokolliert das als Fehler beim Behandeln eines Fehlers. Danach hängt Symfony die ursprüngliche Exception als previous an die neue.

Für dich heißt das: Beide Einträge gehören zu einem einzigen Request. Zähl sie nicht doppelt, und such nicht nach einem zweiten Problem.

Wer schickt so etwas?

Welcher Client es in deinem Shop ist, verrät das Shopware-Log nicht. Die Meldung enthält weder URL noch IP noch User-Agent. Typische Kandidaten sind:

  • Eine Anbindung an Warenwirtschaft, PIM oder Marktplatz, die Daten an die Admin-API schickt und das JSON selbst zusammenbaut. Klassiker sind abgeschnittene Bodies, Steuerzeichen in Produkttexten oder Umlaute in ISO-8859-1 statt UTF-8. PHPs json_decode lehnt ungültiges UTF-8 ab, und schon steht die Meldung im Log.
  • Ein Headless-Frontend oder eine App, die an die Store-API sendet und bei einem Codepfad vergisst, JSON.stringify aufzurufen. Dann geht [object Object] oder ein Form-String mit JSON-Header raus.
  • Webhooks externer Dienste, die an eine URL im Shop gehen, die eigentlich etwas anderes erwartet, oder die bei Retries einen unvollständigen Body schicken.
  • Scanner und Bots. Sicherheitsscanner schicken gern absichtlich kaputtes JSON an alles, was nach API aussieht, um Fehlermeldungen zu provozieren.

Den Absender finden

Weil das Shopware-Log nichts über den Absender sagt, brauchst du das Access-Log des Webservers. Nimm die Uhrzeit aus dem Shopware-Log und such im Access-Log nach Anfragen mit Status 400 in derselben Sekunde. GET-Requests haben meist keinen Body, also sind es fast immer POST, PATCH oder PUT.

# Uhrzeit aus dem Shopware-Log, z. B. 14:03:27
grep '14:03:27' /var/log/nginx/access.log | grep '" 400 '

Bei Apache liegt das Log je nach Setup unter /var/log/apache2/ oder im Log-Verzeichnis deines Hosters. Aus dem Treffer liest du drei Dinge ab: den Pfad (/api/..., /store-api/... oder etwas Fremdes), die IP und den User-Agent. Damit lässt sich die Quelle meist schon zuordnen. Eine bekannte Server-IP mit dem User-Agent GuzzleHttp/7 ist eher die eigene Schnittstelle als ein Bot, python-requests auf einem Pfad wie /wp-json/ eher ein Scanner.

Reicht das nicht, hilft es, den Content-Type vorübergehend mitzuloggen. Bei nginx gibt es dafür die Variable $content_type:

log_format with_ct '$remote_addr [$time_local] "$request" $status '
                   '"$http_user_agent" ct="$content_type"';
access_log /var/log/nginx/access_ct.log with_ct;

Den Body selbst würde ich nicht ins Access-Log schreiben. Da landen sonst Kundendaten und Zugangsdaten in Textdateien, die niemand mehr aufräumt.

Zum Gegencheck kannst du den Fehler selbst auslösen:

curl -i -X POST https://dein-shop.example/ \
  -H 'Content-Type: application/json' \
  --data '{kaputt'

Die Antwort kommt mit Status 400, und im Log stehen danach genau die beiden Zeilen von oben. Damit weißt du auch, dass deine Log-Auswertung die Uhrzeit richtig zuordnet.

Was du tun solltest

Das hängt komplett vom Absender ab.

Ist es deine eigene Integration, liegt der Fehler dort, nicht in Shopware. Lass dir vom Anbieter oder Entwickler zeigen, welcher Body bei den betroffenen Anfragen rausgeht. Meist ist es ein Encoding-Problem bei bestimmten Datensätzen, die sich über Zeitpunkt und Pfad aus dem Access-Log eingrenzen lassen. Wichtig: Diese Anfragen sind fehlgeschlagen. Wenn es Bestands- oder Preisupdates waren, sind sie nicht im Shop angekommen.

Ist es ein externer Webhook, prüfe, ob die URL in der Konfiguration des Dienstes noch stimmt. Nach Domainumzügen oder Plugin-Wechseln zeigt so etwas gern ins Leere.

Sind es Bots, kannst du die IPs oder User-Agents vor dem Shop sperren, in der Firewall, per nginx oder beim Hoster. Ändern musst du in Shopware nichts, die 400 ist hier die richtige Antwort.

Und wenn du die Meldung nur aus dem Log haben willst: Shopware kennt seit 6.4.4.0 die Einstellung shopware.logger.exclude_exception. Der zuständige ExcludeExceptionHandler vergleicht den exakten Klassennamen.

# config/packages/shopware.yaml
shopware:
    logger:
        exclude_exception:
            - Symfony\Component\HttpKernel\Exception\BadRequestHttpException

Das ist ein Workaround mit Nebenwirkung. Damit verschwindet jede BadRequestHttpException aus dem Haupt-Log, nicht nur diese eine Meldung. Wenn eine eigene Integration betroffen ist, siehst du ihre Fehler danach nicht mehr. Ich würde das erst eintragen, wenn du den Absender kennst und weißt, dass er dich nicht interessiert.

Im Shopware-Repository habe ich zu dieser Meldung kein Issue gefunden. Das passt zum Bild: Der Listener tut, was er soll.

Ob hinter den Einträgen ein Scanner steckt oder eine Schnittstelle, die seit Tagen keine Bestände mehr überträgt, siehst du nur, wenn du regelmäßig ins Log schaust. ShopSignal liest die Fehler deines Shopware-6-Shops aus dem Log und zeigt dir pro Meldung, wie oft sie zuletzt aufgetreten ist. Springt „The JSON payload is malformed.“ von ein paar Einträgen auf Hunderte, lohnt sich der Blick ins Access-Log meist sofort.