Shopware 6 Update: JSON Column-Type Fehler beheben

Typische Fehlermeldungen:

Invalid JSON text: "Invalid value." at position 0

Oder:

Doctrine\DBAL\Exception\InvalidFieldNameException

Die Migration erwartet gültiges JSON, findet aber:

• Leere Strings ('')
  • Den String "null" statt echtem NULL
    • Ungültige JSON-Syntax
      • Alte Serialisierungsformate

JSON-Probleme treten besonders häufig in diesen Spalten auf:

- custom_fields – Produkteigenschaften, Kundenattribute

• config – Plugin-Konfigurationen
  • payload – Flow-Builder, Mail-Templates
    • translated – Übersetzungsdaten
      • price – Preisstrukturen

        Typische Szenarien:

        • Shop wurde von Shopware 6.2–6.4 migriert
          • Plugins haben Daten unsauber geschrieben
            • Import-Skripte haben leere Werte gesetzt
              • Manuelle SQL-Updates mit falschen Werten

MySQL bietet die Funktion JSON_VALID() zum Prüfen:

-- Produkte mit ungültigen custom_fields finden
SELECT id, product_number, custom_fields
FROM product
WHERE custom_fields IS NOT NULL
  AND custom_fields != ''
  AND JSON_VALID(custom_fields) = 0;

Leere Strings finden (häufigste Ursache):

-- Leere Strings in custom_fields
SELECT id, product_number
FROM product
WHERE custom_fields = '';

Auch Übersetzungstabellen prüfen:

SELECT product_id, custom_fields
FROM product_translation
WHERE custom_fields = ''
   OR (custom_fields IS NOT NULL AND JSON_VALID(custom_fields) = 0);

Leere Strings durch leeres JSON-Objekt ersetzen:

-- product Tabelle
UPDATE product
SET custom_fields = '{}'
WHERE custom_fields = '' OR custom_fields IS NULL;
-- product_translation Tabelle
UPDATE product_translation
SET custom_fields = '{}'
WHERE custom_fields = '' OR custom_fields IS NULL;

Für andere Tabellen analog:

-- Kategorien
UPDATE category_translation
SET custom_fields = '{}'
WHERE custom_fields = '' OR custom_fields IS NULL;
-- Kunden
UPDATE customer
SET custom_fields = '{}'
WHERE custom_fields = '' OR custom_fields IS NULL;

Danach Migration erneut starten:

php bin/console database:migrate --all

String "null" durch echtes NULL ersetzen:

UPDATE product
SET custom_fields = NULL
WHERE custom_fields = 'null';

Defekte JSON-Arrays reparieren:

-- Wenn Arrays mit Trailing Comma existieren
UPDATE product
SET custom_fields = REPLACE(custom_fields, ',}', '}')
WHERE custom_fields LIKE '%,}';
UPDATE product
SET custom_fields = REPLACE(custom_fields, ',]', ']')
WHERE custom_fields LIKE '%,]';

Alle Tabellen mit custom_fields auf einmal prüfen:

-- Übersicht aller problematischen Einträge
SELECT 'product' as tbl, COUNT(*) as cnt FROM product WHERE custom_fields = ''
UNION SELECT 'product_translation', COUNT(*) FROM product_translation WHERE custom_fields = ''
UNION SELECT 'category_translation', COUNT(*) FROM category_translation WHERE custom_fields = ''
UNION SELECT 'customer', COUNT(*) FROM customer WHERE custom_fields = '';

Bei eigenen Plugins und Imports:

// Immer valides JSON schreiben
$customFields = $data['custom_fields'] ?? [];
if (empty($customFields)) {
    $customFields = null; // NULL statt leerer String
}

Vor Updates prüfen:

-- Quick-Check für alle wichtigen Tabellen
SELECT 
  'product' as entity,
  SUM(CASE WHEN custom_fields = '' THEN 1 ELSE 0 END) as empty_string,
  SUM(CASE WHEN JSON_VALID(COALESCE(custom_fields, '{}')) = 0 THEN 1 ELSE 0 END) as invalid_json
FROM product;

Import-Skripte validieren:

• Leere Werte als NULL oder {} schreiben
  • JSON vor dem Schreiben validieren
    • Encoding (UTF-8) sicherstellen

JSON-Column-Type-Fehler entstehen meist durch historische Daten aus älteren Shopware-Versionen oder unsaubere Imports. Die Lösung ist einfach:

1. Ungültige Werte finden mit JSON_VALID() und Leerstring-Checks 2. Leere Strings durch {} ersetzen 3. Migration erneut starten

Besonders bei Shops, die von Shopware 6.2–6.4 stammen, solltest du vor jedem Update die JSON-Spalten prüfen. Das spart dir viel Zeit beim Troubleshooting.

Brauchst du Hilfe bei der Datenbereinigung? Als Shopware-Entwickler unterstütze ich dich gerne bei Updates und Migrationen.