MySQL Error 3140: invalid JSON text

In breve: MySQL Error 3140 invalid JSON — indica che il valore inserito in una colonna JSON non è sintatticamente valido.

Cosa indica il problema

MySQL Error 3140 invalid JSON — indica che il valore inserito in una colonna JSON non è sintatticamente valido. La diagnosi deve collegare la prova, l’orario e il primo evento utile nei log prima di cambiare la configurazione.

Sintomi e cause probabili

Sintomi da verificare

• Il comportamento descritto da “MySQL Error 3140: invalid JSON text” si ripete nella stessa operazione
• Il controllo di query, schema e log del database produce un dato coerente con lo stesso orario
• Un tentativo comparabile permette di capire se l’anomalia è generale o limitata a un solo elemento

Cause probabili

• Una colonna o funzione JSON riceve testo non valido
• Schema non allineato alla versione applicativa
• Dato non compatibile con tipo o lunghezza
• Indice oltre i limiti di charset e formato riga

Controlli da eseguire

1. Valida il documento e individua posizione e carattere segnalati
2. Mostrare definizione della tabella e query coinvolta
3. Identificare valore e riga che causano l’errore
4. Confrontare schema atteso e reale
5. Controllare charset, collation, motore e formato riga

Dati utili

• Log MySQL o MariaDB
• PhpMyAdmin o client SQL
• Error_log dell’applicazione chiamante

Correzione sicura

1. Correggi la serializzazione JSON prima di salvare nuovamente il dato
2. Completare una migrazione schema con backup
3. Normalizzare i dati prima dell’inserimento
4. Ridisegnare indici e tipi secondo i limiti reali
5. Usare strumenti di controllo e riparazione adatti al motore

Verifica finale

• La query termina con il risultato previsto
• Schema e vincoli restano coerenti
• Non compaiono nuovi warning o lock
• L’applicazione legge e scrive i dati correttamente

Errori da evitare

• Non disattivare globalmente WAF, ModSecurity, antispam o verifica TLS per aggirare il sintomo
• Non impostare permessi 777 e non cambiare proprietari in modo ricorsivo senza conoscere la struttura dell’account
• Non cancellare database, chiavi Redis, cache o file di sistema senza backup e senza aver identificato l’oggetto coinvolto
• Non ripetere pagamenti, import o webhook reali finché non hai verificato l’idempotenza

Guide Xlogic correlate

• MySQL Error 1300: invalid utf8 character string
• MySQL Error 2026: SSL connection error
• MySQL Error 1055: not in GROUP BY

Fonti tecniche

• MySQL 8.4 Reference Manual
• MariaDB Documentation

Domande frequenti