binascii.Error: Non-hexadecimal digit found
binascii.unhexlify() (sau a2b_hex) a găsit în text un caracter care nu e cifră hex: prefixul 0x, un spațiu, o literă după f sau un caracter invizibil. Curăță textul (fără 0x, fără spații) înainte de conversie.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
binascii.unhexlify(text) face același lucru ca bytes.fromhex(text): transformă un text hex în bytes, câte două cifre pentru fiecare octet. Cifrele hex permise sunt doar 0-9 și a-f (sau A-F). Mesajul îți spune că a dat peste altceva, dar, spre deosebire de fromhex, nu îți spune poziția.
Cauzele tipice în blockchain: adrese și hash-uri cu prefixul 0x (x nu e cifră hex), texte copiate de pe un explorator cu spații sau cu un rând nou la final, litera O în loc de cifra 0, sau un text care nu e hex deloc (Base58, Base64). Spre deosebire de bytes.fromhex, unhexlify nu acceptă nici măcar spațiile dintre octeți. Dacă textul are număr impar de caractere, eroarea e alta: Odd-length string.
De ce apare: cauzele frecvente
1Prefixul 0x lăsat în text
import binascii
adresa = "0x52908400098527886E0F7030069857D2E4169EE7"
b = binascii.unhexlify(adresa)import binascii
adresa = "0x52908400098527886E0F7030069857D2E4169EE7"
b = binascii.unhexlify(adresa.removeprefix("0x"))0x arată doar că urmează un număr hex; nu face parte din octeți.
2Spații sau rând nou în text
import binascii
h = "9f86 d081 884c\n"
b = binascii.unhexlify(h)import binascii
h = "9f86 d081 884c\n"
b = binascii.unhexlify("".join(h.split()))"".join(h.split()) elimină toate spațiile și rândurile noi.
Repară eroarea, direct în pagină
Codul de mai jos transformă în bytes trei adrese copiate de pe un explorator, ca să afișeze lungimea fiecăreia, dar dă binascii.Error: Non-hexadecimal digit found. Repară funcția curata ca toate trei să se convertească și programul să afișeze <primele 8 caractere> 20 bytes pentru fiecare.
import binascii
adrese = [
"0x52908400098527886E0F7030069857D2E4169EE7",
" 0x8617E340B3D01FA5F11F306F4090FD50E238070D\n",
"de709f2102306220921060314715629080e2fb77",
]
def curata(a):
return a
for a in adrese:
c = curata(a)
b = binascii.unhexlify(c)
print(c[:8].lower(), len(b), "bytes")52908400 20 bytes 8617e340 20 bytes de709f21 20 bytes
Indiciu
Scoate spațiile de la capete și prefixul 0x înainte de conversie.
Reparația
import binascii
adrese = [
"0x52908400098527886E0F7030069857D2E4169EE7",
" 0x8617E340B3D01FA5F11F306F4090FD50E238070D\n",
"de709f2102306220921060314715629080e2fb77",
]
def curata(a):
return a.strip().removeprefix("0x")
for a in adrese:
c = curata(a)
b = binascii.unhexlify(c)
print(c[:8].lower(), len(b), "bytes")De ce merge
unhexlify acceptă doar cifre hex, iar x din 0x, spațiile și \n nu sunt cifre hex. strip() scoate spațiile și rândul nou de la capete, iar removeprefix("0x") scoate prefixul doar dacă există, deci a treia adresă rămâne neschimbată. O adresă Ethereum are 40 de cifre hex, adică 20 de bytes.
Alte forme ale mesajului
binascii.Error: Odd-length stringbinascii.Error: Non-hexadecimal digit found (a2b_hex)
Cum o eviți pe viitor
Normalizează orice text hex primit din afară într-o singură funcție: strip(), scoate 0x, scoate spațiile, apoi convertește. Dacă nu ai nevoie de binascii, folosește bytes.fromhex: acceptă spațiile dintre octeți și, când greșești, îți spune și poziția caracterului greșit.
Întrebări frecvente
E la fel cu „non-hexadecimal number found in fromhex() arg”?
Aceeași cauză, altă funcție. bytes.fromhex îți dă și poziția, binascii.unhexlify doar spune că a găsit un caracter greșit.
Majusculele contează?
Nu. A-F și a-f sunt acceptate la fel. Adresele Ethereum cu majuscule (EIP-55) se convertesc fără probleme, după ce scoți 0x.
Erori înrudite
ValueError: non-hexadecimal number found in fromhex() arg at position 1 Textul dat lui bytes.fromhex conține un caracter care nu e cifră hex, de obicei prefixul 0x (x este la poziția 1). Taie prefixul înainte: bytes.fromhex(valoare.removeprefix("0x")). ValueError: fromhex() arg must contain an even number of hexadecimal digits Textul hex are un număr impar de cifre, deci ultimul octet e incomplet. De obicei lipsește un 0 la început (de la hex(n)) sau ai tăiat greșit textul: completează cu zfill sau folosește n.to_bytes(...). binascii.Error: Incorrect padding base64.b64decode() a primit un text Base64 cu lungime greșită: lipsesc semnele = de la final sau textul a fost tăiat. Verifică textul întreg; dacă vine dintr-o sursă care omite =, completează cu "=" * (-len(t) % 4). Î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.
