...
Eroare Python · Date: JSON, text și date calendaristice

TypeError: Strings must be encoded before hashing

Pe scurt

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

Greșit
PYTHON
import hashlib
h = hashlib.sha256("fisier.txt").hexdigest()
Corect
PYTHON
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

Greșit
PYTHON
import hashlib
h = hashlib.md5()
for linie in ["a", "b"]:
    h.update(linie)
Corect
PYTHON
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

Greșit
PYTHON
import hashlib
id_comanda = 1024
h = hashlib.sha1(str(id_comanda)).hexdigest()
Corect
PYTHON
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ă tu

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.

Codul care dă eroarea
PYTHON
import hashlib

text = "parola123"
amprenta = hashlib.sha256(text).hexdigest()
print(amprenta[:16])
După reparație, programul afișează
a3a2754f94b4f8c1
Indiciu

hashlib lucrează pe octeți; textul trebuie codificat în UTF-8.

Alte forme ale mesajului

  • TypeError: Unicode-objects must be encoded before hashing
  • TypeError: 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, bcrypt sau argon2, 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

← Toate erorile Python

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