TypeError: the JSON object must be str, bytes or bytearray, not dict
Ai dat lui json.loads() ceva care nu e text JSON: un dicționar deja decodat, o listă, None sau un fișier deschis. Dacă ai deja dict, folosește-l direct; pentru fișier, folosește json.load(f) (fără s).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
json.loads(s) („load string”) transformă un text JSON în obiecte Python: '{"a": 1}' devine {"a": 1}. De aceea cere un str, bytes sau bytearray. Mesajul îți spune ce tip a primit în schimb: not dict, not list, not NoneType, not TextIOWrapper.
not dict sau not list înseamnă aproape mereu că datele sunt deja decodate: au venit dintr-un response.json(), dintr-un json.load anterior sau dintr-un framework care parsează singur corpul cererii. Nu mai e nimic de transformat.
not TextIOWrapper înseamnă că i-ai dat un fișier deschis; pentru fișiere există json.load(f), fără s. not NoneType înseamnă că o funcție sau o variabilă care ar fi trebuit să conțină textul e None.
De ce apare: cauzele frecvente
1Datele sunt deja un dicționar
import json
raspuns = {"id": 7, "nume": "Ana"}
date = json.loads(raspuns)raspuns = {"id": 7, "nume": "Ana"}
date = raspuns
print(date["nume"])Un dict nu trebuie decodat; îl folosești direct.
2json.loads pe un fișier deschis
import json
with open("config.json", "w") as f:
f.write('{"port": 8080}')
with open("config.json") as f:
config = json.loads(f)import json
with open("config.json", "w") as f:
f.write('{"port": 8080}')
with open("config.json") as f:
config = json.load(f)
print(config["port"])json.load(f) citește din fișier; json.loads(text) lucrează pe un text. Aici mesajul e not TextIOWrapper.
3Textul lipsește (None)
import json
def citeste_cache():
pass
date = json.loads(citeste_cache())import json
def citeste_cache():
return '{"vizite": 3}'
date = json.loads(citeste_cache())
print(date["vizite"])Funcția fără return întoarce None, iar mesajul devine not NoneType.
Repară eroarea, direct în pagină
Funcția nume_clienti primește răspunsul unei API, care a fost deja decodat într-un dicționar, dar o apelezi și dă TypeError: the JSON object must be str, bytes or bytearray, not dict. Repar-o ca programul să afișeze Ana, Mihai.
import json
def nume_clienti(raspuns):
date = json.loads(raspuns)
return ", ".join(c["nume"] for c in date["clienti"])
raspuns = {"clienti": [{"nume": "Ana"}, {"nume": "Mihai"}]}
print(nume_clienti(raspuns))Ana, Mihai
Indiciu
Datele primite nu mai sunt text JSON.
Reparația
def nume_clienti(raspuns):
return ", ".join(c["nume"] for c in raspuns["clienti"])
raspuns = {"clienti": [{"nume": "Ana"}, {"nume": "Mihai"}]}
print(nume_clienti(raspuns))De ce merge
json.loads transformă un text JSON în obiecte Python, dar raspuns era deja un dicționar, deci nu avea ce decoda. Funcția lucrează acum direct pe dicționar: ia lista clienti, scoate câmpul nume din fiecare element și le unește cu ", ".
Alte forme ale mesajului
TypeError: the JSON object must be str, bytes or bytearray, not listTypeError: the JSON object must be str, bytes or bytearray, not TextIOWrapperTypeError: the JSON object must be str, bytes or bytearray, not NoneType
Cum o eviți pe viitor
- Ține minte perechile:
loads/dumpslucrează cu texte,load/dumpcu fișiere. - Înainte de
json.loads(x), verificătype(x): dacă edictsaulist, datele sunt deja decodate. - La
requests,response.json()întoarce direct obiectele Python; nu mai aplicajson.loadspeste el. - Decodează JSON-ul o singură dată, la intrarea datelor în program.
Întrebări frecvente
Cum transform un dict în text JSON?
Cu json.dumps(d). E operația inversă lui loads. Dacă vrei un text frumos formatat, json.dumps(d, indent=2, ensure_ascii=False) păstrează și diacriticele.
De ce acceptă și bytes?
Pentru că datele din rețea vin des ca octeți. json.loads(b'{"a": 1}') detectează singur codificarea UTF-8/16/32.
Erori înrudite
json.decoder.JSONDecodeError: Expecting value: line 1 column 1 (char 0) Ai dat lui `json.loads()` / `json.load()` un text care nu e JSON: un text gol, o pagină HTML (eroare 404/500 de la un API) sau un fișier gol. „line 1 column 1 (char 0)” înseamnă că problema e chiar de la primul caracter. Afișează textul primit înainte de parsare. 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)`. AttributeError: 'str' object has no attribute 'read' Ai dat unei funcții care așteaptă un fișier deschis (de exemplu `json.load`) un text: numele fișierului sau conținutul lui. Pentru un nume, deschide întâi fișierul: `with open("comanda.json") as f: json.load(f)`; pentru un text JSON, folosește `json.loads(text)`. Î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.
