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

UnicodeEncodeError: 'ascii' codec can't encode character '\u0103' in position 4: ordinal not in range(128)

Pe scurt

Ai encodat cu "ascii" un text cu diacritice (ă, ș, ț) sau alte caractere în afara ASCII. ASCII are doar 128 de caractere. Folosește .encode("utf-8") (sau .encode() simplu), care poate reprezenta orice caracter.

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

Ce înseamnă

Bucată cu bucată: 'ascii' codec este encoding-ul folosit; can't encode character '\u0103' este caracterul care nu încape (aici ă, codul Unicode U+0103); in position 4 e poziția lui în text (de la 0); ordinal not in range(128) înseamnă că ASCII acceptă doar codurile 0–127.

În blockchain apare când hash-uiești sau semnezi texte cu nume și descrieri românești și ai scris .encode("ascii"), ca într-un exemplu vechi. Uneori vine indirect: un modul sau un mediu configurat cu ASCII ca encoding implicit. Pe lângă eroare, e și o problemă de consens: toate nodurile trebuie să transforme textul în aceiași bytes, altfel hash-urile diferă. UTF-8 este standardul de facto și e implicit în str.encode(). Folosește poziția din mesaj ca să găsești caracterul: text[4].

De ce apare: cauzele frecvente

1encode("ascii") pe un text cu diacritice

Greșit
PYTHON
import hashlib
h = hashlib.sha256("plată".encode("ascii"))
Corect
PYTHON
import hashlib
h = hashlib.sha256("plată".encode("utf-8"))

ă nu există în ASCII. UTF-8 îl reprezintă pe doi bytes.

2errors="ignore" ca „reparație”

Greșit
PYTHON
date = "Ștefan->Ana:3".encode("ascii", errors="ignore")
Corect
PYTHON
date = "Ștefan->Ana:3".encode("utf-8")

Cu ignore dispare Ș, deci hash-ul e al altui text. Două nume diferite pot ajunge la aceleași bytes.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos calculează hash-urile a două tranzacții cu nume românești, dar dă UnicodeEncodeError: 'ascii' codec can't encode character. Repară encoding-ul ca programul să afișeze câți bytes are fiecare text și primele 16 caractere din hash.

Codul care dă eroarea
PYTHON
import hashlib

for tx in ["Ana->Bogdan:5", "Ștefan->Iulia:2"]:
    b = tx.encode("ascii")
    print(tx, len(b), hashlib.sha256(b).hexdigest()[:16])
După reparație, programul afișează
Ana->Bogdan:5 13 beb569b0b76ffeb6
Ștefan->Iulia:2 16 f3e17b8121943a72
Indiciu

Folosește encoding-ul care poate reprezenta orice caracter.

Alte forme ale mesajului

  • UnicodeEncodeError: 'ascii' codec can't encode character '\u0219' in position 0: ordinal not in range(128)
  • UnicodeEncodeError: 'ascii' codec can't encode characters in position 0-1: ordinal not in range(128)
  • UnicodeEncodeError: 'latin-1' codec can't encode character '\u021b' in position 3: ordinal not in range(256)

Cum o eviți pe viitor

Scrie .encode() fără argument (UTF-8) sau explicit .encode("utf-8") peste tot unde transformi text în bytes, și .decode("utf-8") la loc. Nu folosi errors="ignore" sau "replace" în date care se hash-uiesc sau se semnează: schimbă conținutul fără să te anunțe. Testează funcțiile de hash cu cel puțin un text cu ă, ș, ț.

Întrebări frecvente

De ce dă eroare și la ș, nu doar la ă?

Toate literele românești cu diacritice sunt în afara ASCII. Și latin-1 le refuză pe ș și ț (U+0219, U+021B), pentru că are doar 256 de caractere.

Hash-ul diferă dacă encodez cu UTF-8 sau UTF-16?

Da. Același text dă bytes diferiți în encoding-uri diferite, deci hash-uri diferite. De aceea toate nodurile trebuie să folosească același encoding.

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.