TypeError: Strings must be encoded before hashing
Funcțiile din hashlib (sha256, md5...) lucrează pe octeți, nu pe text. Transformă textul cu .encode("utf-8") înainte: hashlib.sha256(parola.encode("utf-8")).hexdigest().
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un hash (SHA-256, MD5, SHA-1) se calculează peste octeți. Același text poate deveni octeți diferiți în codificări diferite (ș în UTF-8 e altceva decât în Latin-2), deci și hash-ul ar fi diferit. Ca să nu ghicească, hashlib refuză textul și îți cere să alegi tu codificarea.
Strings must be encoded before hashing apare la crearea obiectului (hashlib.sha256("text")) sau la .update("text"). În Python 3.8 și mai vechi, mesajul era Unicode-objects must be encoded before hashing.
Reparația e .encode("utf-8") pe text. Folosește aceeași codificare peste tot unde calculezi hash-ul aceleiași valori, altfel hash-urile nu se vor potrivi la comparare. Pentru parole reale, nu folosi direct sha256, ci o funcție lentă cu salt, de exemplu hashlib.pbkdf2_hmac, bcrypt sau argon2.
De ce apare: cauzele frecvente
1Text dat direct funcției de hash
import hashlib
h = hashlib.sha256("fisier.txt").hexdigest()import hashlib
h = hashlib.sha256("fisier.txt".encode("utf-8")).hexdigest()
print(len(h)).encode("utf-8") produce octeții peste care se calculează hash-ul.
2update() cu text
import hashlib
h = hashlib.md5()
for linie in ["a", "b"]:
h.update(linie)import hashlib
h = hashlib.md5()
for linie in ["a", "b"]:
h.update(linie.encode("utf-8"))
print(h.hexdigest())Și update cere octeți; fiecare bucată trebuie codificată.
3Număr sau alt tip transformat greșit
import hashlib
id_comanda = 1024
h = hashlib.sha1(str(id_comanda)).hexdigest()import hashlib
id_comanda = 1024
h = hashlib.sha1(str(id_comanda).encode("utf-8")).hexdigest()
print(len(h))str(...) dă tot text; mai trebuie pasul .encode().
Repară eroarea, direct în pagină
Programul calculează amprenta SHA-256 a unui text ca să verifice dacă s-a schimbat, dar linia cu hashlib.sha256(...) dă TypeError: Strings must be encoded before hashing. Repar-o ca programul să afișeze primele 16 caractere ale amprentei, a3a2754f94b4f8c1.
import hashlib
text = "parola123"
amprenta = hashlib.sha256(text).hexdigest()
print(amprenta[:16])a3a2754f94b4f8c1
Indiciu
hashlib lucrează pe octeți; textul trebuie codificat în UTF-8.
Reparația
import hashlib
text = "parola123"
amprenta = hashlib.sha256(text.encode("utf-8")).hexdigest()
print(amprenta[:16])De ce merge
Funcția de hash calculează peste octeți, iar text era un str. text.encode("utf-8") îl transformă în octeții lui UTF-8, peste care sha256 calculează amprenta. hexdigest() o întoarce ca text hexazecimal de 64 de caractere, din care afișăm primele 16.
Alte forme ale mesajului
TypeError: Unicode-objects must be encoded before hashingTypeError: object supporting the buffer API required
Cum o eviți pe viitor
- Scrie o funcție mică, de exemplu
def sha256_text(t): return hashlib.sha256(t.encode("utf-8")).hexdigest(), și folosește-o peste tot. - Alege o singură codificare (
utf-8) pentru toate hash-urile aceleiași aplicații. - Pentru fișiere, deschide-le în modul binar (
"rb"): primești direct octeți. - Pentru parole, folosește
pbkdf2_hmac,bcryptsauargon2, nu un hash simplu.
Întrebări frecvente
Ce înseamnă varianta object supporting the buffer API required?
Ai dat un obiect care nu e nici text, nici octeți, de exemplu un număr: hashlib.sha256(5). Transformă-l întâi în text, apoi în octeți: str(5).encode().
De ce hash-ul meu diferă de cel de pe un site?
De obicei din cauza codificării sau a unui caracter invizibil: un \n la final, un spațiu, o diacritică codificată diferit. Afișează repr(text) și asigură-te că folosești utf-8.
Erori înrudite
TypeError: a bytes-like object is required, not 'str' Amesteci bytes (`b"..."`) cu texte (`str`): de exemplu faci `split(",")` pe date binare, cauți un text într-un bytes sau scrii text într-un fișier deschis cu `"wb"`. Decodează datele cu `.decode("utf-8")` sau lucrează doar cu bytes (`b","`). TypeError: string argument without an encoding Ai apelat bytes("text") sau bytearray("text") fără să spui cum se transformă textul în octeți. Adaugă codificarea: bytes("text", "utf-8") sau, mai simplu, "text".encode("utf-8"). UnicodeEncodeError: 'ascii' codec can't encode character '\u0219' in position 3: ordinal not in range(128) Încerci să transformi în bytes (să scrii, să afișezi sau să trimiți) un text cu diacritice folosind un encoding care nu le are, de obicei ASCII. Folosește UTF-8: `text.encode("utf-8")`, `open(..., encoding="utf-8")` sau setează `PYTHONIOENCODING=utf-8` pentru terminal. Î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.
