...
Eroare Python · Date: JSON, text și date calendaristice

TypeError: keys must be str, int, float, bool or None, not tuple

Pe scurt

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

Greșit
PYTHON
import json
vanzari = {("Cluj", "ian"): 1200, ("Iași", "ian"): 900}
print(json.dumps(vanzari))
Corect
PYTHON
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ă

Greșit
PYTHON
import json
from datetime import date
prezenta = {date(2025, 3, 1): 18}
print(json.dumps(prezenta))
Corect
PYTHON
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ă tu

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}.

Codul care dă eroarea
PYTHON
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))
După reparație, programul afișează
{"Cluj/ian": 2, "Iași/feb": 1}
Indiciu

Construiește un dicționar nou în care fiecare cheie tuplu devine un text.

Alte forme ale mesajului

  • TypeError: keys must be str, int, float, bool or None, not datetime.date
  • TypeError: keys must be str, int, float, bool or None, not decimal.Decimal
  • TypeError: 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 și fromisoformat() 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

← Toate erorile Python

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.