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

TypeError: the JSON object must be str, bytes or bytearray, not dict

Pe scurt

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

Greșit
PYTHON
import json
raspuns = {"id": 7, "nume": "Ana"}
date = json.loads(raspuns)
Corect
PYTHON
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

Greșit
PYTHON
import json
with open("config.json", "w") as f:
    f.write('{"port": 8080}')
with open("config.json") as f:
    config = json.loads(f)
Corect
PYTHON
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)

Greșit
PYTHON
import json
def citeste_cache():
    pass
date = json.loads(citeste_cache())
Corect
PYTHON
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ă tu

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.

Codul care dă eroarea
PYTHON
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))
După reparație, programul afișează
Ana, Mihai
Indiciu

Datele primite nu mai sunt text JSON.

Alte forme ale mesajului

  • TypeError: the JSON object must be str, bytes or bytearray, not list
  • TypeError: the JSON object must be str, bytes or bytearray, not TextIOWrapper
  • TypeError: the JSON object must be str, bytes or bytearray, not NoneType

Cum o eviți pe viitor

  • Ține minte perechile: loads/dumps lucrează cu texte, load/dump cu fișiere.
  • Înainte de json.loads(x), verifică type(x): dacă e dict sau list, datele sunt deja decodate.
  • La requests, response.json() întoarce direct obiectele Python; nu mai aplica json.loads peste 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

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