...
Eroare Blockchain · Serializarea blocurilor în JSON

TypeError: Object of type bytes is not JSON serializable

Pe scurt

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()

Greșit
PYTHON
bloc = {"index": 2, "hash_anterior": hashlib.sha256(b"bloc 1").digest()}
json.dumps(bloc)
Corect
PYTHON
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

Greșit
PYTHON
tx = {"de_la": "ana", "semnatura": semnatura_bytes}
json.dumps(tx)
Corect
PYTHON
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

Greșit
PYTHON
tx = {"mesaj": "plata 10".encode()}
Corect
PYTHON
tx = {"mesaj": "plata 10"}

Encodează abia la final, după json.dumps: json.dumps(tx).encode().

Repară tu

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

Codul care dă eroarea
PYTHON
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])
După reparație, programul afișează
JSON: {"date":"Ana -> Bogdan 5","hash_anterior":"5d83182bc884cf12a
Hash: 9ef91903af89a70c
Indiciu

Folosește metoda care dă hash-ul ca text, nu ca bytes.

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

← Toate erorile Blockchain

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ță 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.