UnicodeEncodeError: 'ascii' codec can't encode character '\u0103' in position 4: ordinal not in range(128)
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
import hashlib
h = hashlib.sha256("plată".encode("ascii"))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”
date = "Ștefan->Ana:3".encode("ascii", errors="ignore")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ă 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.
import hashlib
for tx in ["Ana->Bogdan:5", "Ștefan->Iulia:2"]:
b = tx.encode("ascii")
print(tx, len(b), hashlib.sha256(b).hexdigest()[:16])Ana->Bogdan:5 13 beb569b0b76ffeb6 Ștefan->Iulia:2 16 f3e17b8121943a72
Indiciu
Folosește encoding-ul care poate reprezenta orice caracter.
Reparația
import hashlib
for tx in ["Ana->Bogdan:5", "Ștefan->Iulia:2"]:
b = tx.encode("utf-8")
print(tx, len(b), hashlib.sha256(b).hexdigest()[:16])De ce merge
ASCII are doar 128 de caractere, iar Ș nu e printre ele. UTF-8 reprezintă orice caracter Unicode: literele ASCII pe un byte, Ș pe doi. De aceea al doilea text are 16 bytes, deși are 15 caractere. Hash-ul e calculat din toate caracterele, fără să se piardă vreunul.
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
UnicodeDecodeError: 'utf-8' codec can't decode byte 0x81 in position 2: invalid start byte Ai încercat să transformi în text cu .decode() bytes care nu sunt text, de obicei un digest() de hash sau o cheie. Pentru afișare sau stocare folosește .hex(), nu .decode(). 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(). LookupError: 'hex' is not a text encoding; use codecs.encode() to handle arbitrary codecs Ai scris .encode("hex") sau .decode("hex"), forma din Python 2. În Python 3, pentru bytes → hex folosești b.hex(), iar pentru hex → bytes bytes.fromhex(text). Pentru textul unui hash, hexdigest() îți dă direct hex-ul. Î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.
