TypeError: Strings must be encoded before hashing
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
import hashlib
mesaj = "Ana trimite 5 lui Bogdan"
h = hashlib.sha256(mesaj).hexdigest()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
import hashlib, json
bloc = {"index": 1, "date": "plata 10"}
text = json.dumps(bloc, sort_keys=True)
h = hashlib.sha256(text).hexdigest()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
import hashlib
h = hashlib.sha256()
h.update("bloc 1")
print(h.hexdigest())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ă 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: ....
import hashlib
tranzactie = "Ana -> Bogdan: 5 monede"
h = hashlib.sha256(tranzactie).hexdigest()
print("Hash:", h)
print("Scurt:", h[:16])Hash: 6ae79c425a1e75e1186a70db059123a7171358db6396b527726794e11904c3d0 Scurt: 6ae79c425a1e75e1
Indiciu
Transformă textul în bytes cu .encode() înainte să-l dai lui sha256.
Reparația
import hashlib
tranzactie = "Ana -> Bogdan: 5 monede"
h = hashlib.sha256(tranzactie.encode()).hexdigest()
print("Hash:", h)
print("Scurt:", h[:16])De ce merge
hashlib.sha256 calculează amprenta unui șir de bytes, nu a unui text. tranzactie.encode() transformă textul în bytes UTF-8, iar apoi hexdigest() întoarce hash-ul ca text hex de 64 de caractere. Același text encodat la fel dă mereu același hash, de aceea orice nod din rețea poate recalcula și verifica amprenta tranzacției.
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
TypeError: object supporting the buffer API required Ai dat funcției hash un număr, None sau alt obiect care nu e bytes. Transformă valoarea întâi în text și apoi în bytes, de exemplu hashlib.sha256(str(nonce).encode()). AttributeError: 'bytes' object has no attribute 'encode' Ai apelat .encode() pe ceva care e deja bytes, de exemplu pe un digest() sau pe un literal b"...". Șterge .encode(): valoarea se poate da direct funcției hash. TypeError: string argument without an encoding Ai apelat bytes(text) fără să spui codificarea. Scrie text.encode() sau bytes(text, "utf-8"). Î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.
