TypeError: keys must be str, int, float, bool or None, not tuple
json.dumps a primit un dicționar ale cărui chei sunt tupluri (sau alte obiecte). În JSON cheile sunt mereu texte, iar Python acceptă să convertească doar chei simple. Transformă cheile în text înainte, de exemplu "Cluj-ian" în loc de ("Cluj", "ian"), sau salvează datele ca listă de obiecte.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În Python, cheile unui dicționar pot fi orice valoare hashable: texte, numere, tupluri, date, frozenset. În JSON, cheile obiectelor sunt întotdeauna texte. La serializare, json.dumps convertește automat cheile simple (int, float, bool, None devin texte), dar nu știe cum să transforme un tuplu sau un obiect, așa că ridică keys must be str, int, float, bool or None, not tuple.
Apare des după grupări: vanzari[(oras, luna)] += suma e un model comod în Python, dar nu se poate salva direct în JSON. La fel cu chei de tip date, datetime sau Decimal (not datetime.date, not decimal.Decimal).
Ai două variante: fie transformi cheile în text (f"{oras}-{luna}", data.isoformat()), fie schimbi structura într-o listă de obiecte ([{"oras": ..., "luna": ..., "suma": ...}]), care se citește mai ușor înapoi. Opțiunea skipkeys=True doar sare peste cheile problematice, deci pierzi date.
De ce apare: cauzele frecvente
1Chei tuplu după o grupare
import json
vanzari = {("Cluj", "ian"): 1200, ("Iași", "ian"): 900}
print(json.dumps(vanzari))import json
vanzari = {("Cluj", "ian"): 1200, ("Iași", "ian"): 900}
rezultat = [{"oras": o, "luna": l, "total": t} for (o, l), t in vanzari.items()]
print(json.dumps(rezultat, ensure_ascii=False))O listă de obiecte păstrează ambele părți ale cheii ca valori separate, ușor de citit înapoi.
2Chei de tip dată
import json
from datetime import date
prezenta = {date(2025, 3, 1): 18}
print(json.dumps(prezenta))import json
from datetime import date
prezenta = {date(2025, 3, 1): 18}
print(json.dumps({d.isoformat(): n for d, n in prezenta.items()}))isoformat() transformă data în textul 2025-03-01, care poate fi cheie JSON.
Repară eroarea, direct în pagină
Programul numără comenzile pe oraș și lună, cu chei de forma (oras, luna), și vrea să le salveze ca JSON, dar json.dumps dă TypeError: keys must be str, int, float, bool or None, not tuple. Transformă cheile în texte de forma oras/luna, ca programul să afișeze {"Cluj/ian": 2, "Iași/feb": 1}.
import json
from collections import Counter
comenzi = [("Cluj", "ian"), ("Iași", "feb"), ("Cluj", "ian")]
numar = Counter(comenzi)
print(json.dumps(dict(numar), ensure_ascii=False)){"Cluj/ian": 2, "Iași/feb": 1}Indiciu
Construiește un dicționar nou în care fiecare cheie tuplu devine un text.
Reparația
import json
from collections import Counter
comenzi = [("Cluj", "ian"), ("Iași", "feb"), ("Cluj", "ian")]
numar = Counter(comenzi)
export = {f"{oras}/{luna}": n for (oras, luna), n in numar.items()}
print(json.dumps(export, ensure_ascii=False))De ce merge
Counter a folosit tuplurile (oras, luna) drept chei, ceea ce în Python e perfect valid. JSON acceptă însă doar chei text, iar json.dumps nu știe să transforme singur un tuplu. Dicționarul export are aceleași numere, dar cu chei text, iar ensure_ascii=False păstrează „ș” din Iași lizibil.
Alte forme ale mesajului
TypeError: keys must be str, int, float, bool or None, not datetime.dateTypeError: keys must be str, int, float, bool or None, not decimal.DecimalTypeError: keys must be str, int, float, bool or None, not frozenset
Cum o eviți pe viitor
- Înainte de a salva în JSON, gândește structura în termeni JSON: chei text, valori simple, liste, obiecte.
- Păstrează cheile compuse în Python, dar construiește o structură separată pentru export.
- Pentru date calendaristice, folosește
isoformat()la scriere șifromisoformat()la citire. - Atenție: cheile numerice devin texte în JSON (
{1: "a"}se citește înapoi ca{"1": "a"}).
Întrebări frecvente
De ce {1: "a"} se salvează, dar cu tuplu nu?
Pentru că json are o regulă simplă de conversie doar pentru tipurile de bază: 1 devine "1". Pentru un tuplu nu există o conversie evidentă, deci biblioteca refuză în loc să ghicească.
Ajută default=str la chei?
Nu, default se aplică doar valorilor, nu cheilor. Pentru chei trebuie să construiești tu un dicționar nou, cu chei text.
Erori înrudite
TypeError: Object of type datetime is not JSON serializable `json.dumps()` știe să transforme doar dicționare, liste, texte, numere, `True`/`False` și `None`. O dată calendaristică, un `Decimal`, un `set` sau un obiect al tău trebuie convertite întâi: `d.isoformat()`, `float(x)`, `list(s)`, sau `json.dumps(date, default=str)`. TypeError: unhashable type: 'list' Folosești o listă drept cheie de dicționar sau ca element într-un set, dar acestea acceptă doar valori imuabile (texte, numere, tupluri). Transformă lista în tuplu (`tuple(lista)`) sau alege altă cheie. json.decoder.JSONDecodeError: Expecting property name enclosed in double quotes: line 1 column 2 (char 1) Textul arată ca JSON, dar cheile sunt scrise cu ghilimele simple (`{'nume': 'Ana'}`), fără ghilimele, sau există o virgulă în plus înaintea lui `}`. JSON cere ghilimele duble. De obicei textul e un dicționar Python afișat cu `str()`: generează-l cu `json.dumps()`. Învață Python de la zero, cu exerciții la fiecare lecție
Curs Python: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
