...
Eroare Blockchain · hashlib: text, bytes și hash-uri

TypeError: Strings must be encoded before hashing

Pe scurt

Ai dat un text (str) direct lui hashlib.sha256, dar funcțiile hash lucrează doar pe bytes. Transformă textul cu .encode() înainte: hashlib.sha256(mesaj.encode()).hexdigest().

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Mesajul îți spune că funcția hash a primit un str și că trebuie mai întâi să-l „encodezi”, adică să-l transformi în bytes. SHA-256 nu știe ce sunt literele: el lucrează pe un șir de octeți. Același text poate deveni bytes diferiți în codificări diferite (UTF-8, UTF-16, Latin-1), așa că Python refuză să aleagă în locul tău.

Eroarea apare la hashlib.sha256(text), la h.update(text) și la hmac.new(cheie, text, ...), de obicei când hash-uiești un mesaj, un bloc serializat cu json.dumps sau un hash anterior păstrat ca text. Linia din mesaj este exact apelul care a primit textul. Reparația standard în cod de blockchain este text.encode(), care folosește UTF-8, aceeași codificare pe care o folosesc toate nodurile, deci toți obțin același hash.

De ce apare: cauzele frecvente

1Textul dat direct lui sha256

Greșit
PYTHON
import hashlib

mesaj = "Ana trimite 5 lui Bogdan"
h = hashlib.sha256(mesaj).hexdigest()
Corect
PYTHON
import hashlib

mesaj = "Ana trimite 5 lui Bogdan"
h = hashlib.sha256(mesaj.encode()).hexdigest()

mesaj este str. .encode() îl transformă în bytes UTF-8, singurul tip pe care îl acceptă funcția hash.

2Blocul serializat cu json.dumps, dar neencodat

Greșit
PYTHON
import hashlib, json

bloc = {"index": 1, "date": "plata 10"}
text = json.dumps(bloc, sort_keys=True)
h = hashlib.sha256(text).hexdigest()
Corect
PYTHON
import hashlib, json

bloc = {"index": 1, "date": "plata 10"}
text = json.dumps(bloc, sort_keys=True)
h = hashlib.sha256(text.encode()).hexdigest()

json.dumps întoarce mereu un str, nu bytes. Pasul .encode() lipsește des tocmai aici.

3update() apelat cu un text

Greșit
PYTHON
import hashlib

h = hashlib.sha256()
h.update("bloc 1")
print(h.hexdigest())
Corect
PYTHON
import hashlib

h = hashlib.sha256()
h.update("bloc 1".encode())
print(h.hexdigest())

update() are aceeași regulă ca sha256(...): primește doar bytes.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă TypeError: Strings must be encoded before hashing. Repară-l ca să afișeze hash-ul SHA-256 al tranzacției și primele 16 caractere ale lui, pe două rânduri: Hash: ... și Scurt: ....

Codul care dă eroarea
PYTHON
import hashlib

tranzactie = "Ana -> Bogdan: 5 monede"
h = hashlib.sha256(tranzactie).hexdigest()
print("Hash:", h)
print("Scurt:", h[:16])
După reparație, programul afișează
Hash: 6ae79c425a1e75e1186a70db059123a7171358db6396b527726794e11904c3d0
Scurt: 6ae79c425a1e75e1
Indiciu

Transformă textul în bytes cu .encode() înainte să-l dai lui sha256.

Alte forme ale mesajului

  • TypeError: Unicode-objects must be encoded before hashing

Cum o eviți pe viitor

Ține minte regula: hash-ul lucrează pe bytes. Scrie o singură funcție ajutătoare, de exemplu def sha(text): return hashlib.sha256(text.encode()).hexdigest(), și folosește-o peste tot în cod: blocuri, tranzacții, Merkle. Așa encodarea se face mereu la fel, cu UTF-8, și nu o mai uiți. Dacă o valoare e deja bytes (de exemplu un digest()), nu o mai encoda a doua oară.

Întrebări frecvente

E aceeași eroare cu „Unicode-objects must be encoded before hashing”?

Da. Așa arăta mesajul în versiunile mai vechi de Python 3. Cauza și reparația sunt identice: transformi textul în bytes cu .encode().

Contează ce codificare folosesc la encode()?

Da. .encode() folosește implicit UTF-8, iar pentru texte cu diacritice alte codificări dau alți bytes, deci alt hash. Folosește UTF-8 peste tot, ca toate nodurile să calculeze același hash pentru aceleași date.

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.