TypeError: Object of type bytes is not JSON serializable
Blocul sau tranzacția pe care o serializezi cu json.dumps conține o valoare bytes, de obicei un digest() sau o semnătură. JSON nu are tip pentru bytes: păstrează valoarea ca text hex (hexdigest() sau .hex()).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
JSON știe doar texte, numere, true/false, null, liste și obiecte. Când json.dumps întâlnește o valoare bytes, nu știe cum să o scrie, așa că oprește programul. În Python 3.14 mesajul are și o notă care spune unde era valoarea, de exemplu „when serializing dict item 'hash_anterior'”, ceea ce te duce direct la câmpul vinovat.
În codul de blockchain apare când pui în bloc rezultatul lui digest() în loc de hexdigest(), o semnătură sau o cheie publică ca bytes, ori un text.encode() uitat. Reparația obișnuită: în structurile de date care se serializează, ține toate valorile binare ca text hex. Când ai nevoie de bytes (pentru hash sau semnătură), le reconstruiești cu bytes.fromhex(...).
De ce apare: cauzele frecvente
1Hash-ul anterior păstrat ca digest()
bloc = {"index": 2, "hash_anterior": hashlib.sha256(b"bloc 1").digest()}
json.dumps(bloc)bloc = {"index": 2, "hash_anterior": hashlib.sha256(b"bloc 1").hexdigest()}
json.dumps(bloc)hexdigest() dă un text, pe care JSON îl poate scrie.
2Semnătura sau cheia publică ca bytes
tx = {"de_la": "ana", "semnatura": semnatura_bytes}
json.dumps(tx)tx = {"de_la": "ana", "semnatura": semnatura_bytes.hex()}
json.dumps(tx).hex() transformă bytes în text, iar bytes.fromhex face drumul invers la verificare.
3Date encodate înainte de a fi puse în dicționar
tx = {"mesaj": "plata 10".encode()}tx = {"mesaj": "plata 10"}Encodează abia la final, după json.dumps: json.dumps(tx).encode().
Repară eroarea, direct în pagină
Codul de mai jos construiește blocul 2 al unui registru și îi calculează hash-ul din JSON, dar dă TypeError: Object of type bytes is not JSON serializable. Repară-l ca hash-ul anterior să fie text hex și afișează JSON: ... și Hash: (primele 16 caractere).
import hashlib, json
hash_anterior = hashlib.sha256(b"bloc 1").digest()
bloc = {"index": 2, "date": "Ana -> Bogdan 5", "hash_anterior": hash_anterior}
text = json.dumps(bloc, sort_keys=True, separators=(",", ":"))
print("JSON:", text[:60])
print("Hash:", hashlib.sha256(text.encode()).hexdigest()[:16])JSON: {"date":"Ana -> Bogdan 5","hash_anterior":"5d83182bc884cf12a
Hash: 9ef91903af89a70cIndiciu
Folosește metoda care dă hash-ul ca text, nu ca bytes.
Reparația
import hashlib, json
hash_anterior = hashlib.sha256(b"bloc 1").hexdigest()
bloc = {"index": 2, "date": "Ana -> Bogdan 5", "hash_anterior": hash_anterior}
text = json.dumps(bloc, sort_keys=True, separators=(",", ":"))
print("JSON:", text[:60])
print("Hash:", hashlib.sha256(text.encode()).hexdigest()[:16])De ce merge
JSON nu are un tip pentru bytes, așa că json.dumps nu poate scrie rezultatul lui digest(). Cu hexdigest(), hash-ul anterior e un text de 64 de caractere și blocul se serializează fără probleme. Cu sort_keys=True și separatori fără spații, aceleași date dau mereu același text, deci același hash pe orice nod.
Alte forme ale mesajului
TypeError: Object of type bytes is not JSON serializable when serializing dict item 'hash_anterior'TypeError: Object of type bytearray is not JSON serializable
Cum o eviți pe viitor
Stabilește o regulă: tot ce intră într-un bloc sau într-o tranzacție e text, număr, listă sau dicționar. Hash-urile, semnăturile și cheile le păstrezi ca hex. Conversia în bytes o faci doar în funcțiile de hash și semnare, chiar înainte să le folosești. Așa structurile se pot serializa, afișa și trimite între noduri fără surprize.
Întrebări frecvente
Pot da json.dumps un default=... care să transforme bytes în hex?
Poți (json.dumps(bloc, default=lambda b: b.hex())), dar la citire vei primi text, nu bytes, deci datele nu mai arată la fel la dus și la întors. E mai clar să ții valorile ca hex de la început.
De ce nu folosesc base64?
Se poate, și unele sisteme o fac. În blockchain (Bitcoin, Ethereum) convenția e hex, așa că valorile tale vor arăta ca cele din exploratoarele de blocuri.
Erori înrudite
TypeError: Object of type Bloc is not JSON serializable Ai dat lui json.dumps un obiect al clasei tale (Bloc, Tranzactie), pe care JSON nu știe să-l scrie. Transformă-l întâi în dicționar, de exemplu cu o metodă ca_dict() sau cu vars(bloc). Hash diferit pentru aceleași date: ordinea cheilor în json.dumps Două dicționare cu aceleași date, dar cu cheile adăugate în altă ordine, dau texte JSON diferite, deci hash-uri diferite. Serializează determinist: json.dumps(date, sort_keys=True, separators=(",", ":")). TypeError: can only concatenate str (not "bytes") to str Ai lipit cu + un text (str) și un bytes, de obicei un hash anterior ca text cu un digest() ca bytes. Lucrează cu un singur tip: folosește hexdigest() peste tot, sau encodează textul înainte să lipești. Învață Blockchain de la zero, cu exerciții la fiecare lecție
Curs Blockchain și criptomonede: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
