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).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Base64 codifică 3 bytes în 4 caractere, deci un text Base64 corect are mereu o lungime multiplu de 4. Când datele nu se împart exact, la final se adaugă = sau == (padding). Mesajul Incorrect padding spune că lungimea textului nu se potrivește: lipsesc caractere sau semne =.
În blockchain Base64 apare la semnături (Bitcoin signmessage întoarce semnătura în Base64), la chei în format PEM, la tranzacții și chei pe Solana și Cosmos, și la token-urile JWT ale API-urilor. Cauze frecvente: textul a fost copiat parțial, s-au pierdut = într-un URL sau într-un JSON, sau textul e Base64 „URL-safe” (fără padding, cu - și _), care se decodează cu base64.urlsafe_b64decode. Atenție și la confuzia de format: un text hex sau Base58 nu e Base64.
De ce apare: cauzele frecvente
1Padding-ul = a fost tăiat
import base64
semn = "SGVsbG8gYmxvY2s"
b = base64.b64decode(semn)import base64
semn = "SGVsbG8gYmxvY2s"
b = base64.b64decode(semn + "=" * (-len(semn) % 4))-len(semn) % 4 calculează câte = lipsesc ca lungimea să fie multiplu de 4.
2Base64 URL-safe decodat cu b64decode
import base64
token = "eyJ0eCI6ImFiIn0"
b = base64.b64decode(token)import base64
token = "eyJ0eCI6ImFiIn0"
b = base64.urlsafe_b64decode(token + "=" * (-len(token) % 4))JWT folosește Base64 URL-safe fără padding: adaugi padding-ul și folosești decodorul URL-safe.
Repară eroarea, direct în pagină
Semnăturile de mai jos au venit printr-un sistem care a tăiat semnele = de la final, iar codul dă binascii.Error: Incorrect padding. Repară funcția decodeaza ca toate trei să se decodeze și programul să afișeze, pentru fiecare, lungimea în bytes și textul decodat.
import base64
semnaturi = ["U2VtbmF0dXJhIEFuYQ", "U2VtbmF0dXJhIEJvZ2Rhbg", "U2VtbmF0dXJhIERhbg"]
def decodeaza(t):
return base64.b64decode(t)
for s in semnaturi:
b = decodeaza(s)
print(len(b), b.decode())13 Semnatura Ana 16 Semnatura Bogdan 13 Semnatura Dan
Indiciu
Lungimea unui text Base64 trebuie să fie multiplu de 4; completează cu =.
Reparația
import base64
semnaturi = ["U2VtbmF0dXJhIEFuYQ", "U2VtbmF0dXJhIEJvZ2Rhbg", "U2VtbmF0dXJhIERhbg"]
def decodeaza(t):
return base64.b64decode(t + "=" * (-len(t) % 4))
for s in semnaturi:
b = decodeaza(s)
print(len(b), b.decode())De ce merge
Base64 grupează caracterele câte 4, iar semnele = completează ultimul grup. Fără ele, lungimea nu e multiplu de 4 și decodorul refuză textul. -len(t) % 4 dă exact câte caractere lipsesc (0, 1 sau 2), iar după completare textul se decodează în bytes-ii originali.
Alte forme ale mesajului
binascii.Error: Invalid base64-encoded string: number of data characters (5) cannot be 1 more than a multiple of 4
Cum o eviți pe viitor
Nu tăia și nu edita de mână textele Base64. Când le pui în URL-uri, folosește base64.urlsafe_b64encode. Când le primești dintr-o sursă care omite padding-ul, completează-l într-o funcție ajutătoare. Verifică formatul înainte: hex are doar 0-9a-f, Base58 nu are 0, O, I, l, iar Base64 poate avea +, / și =.
Întrebări frecvente
De ce uneori merge și fără =?
Dacă lungimea datelor originale e multiplu de 3, textul Base64 nu are deloc =. Problema apare doar când trebuia să existe padding și a fost scos.
Ce înseamnă „cannot be 1 more than a multiple of 4”?
Un text Base64 corect nu poate avea niciodată lungimea 4k + 1, oricât padding ai adăuga. Înseamnă că textul e tăiat sau stricat, nu doar fără =.
Erori înrudite
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. 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(). cryptography.exceptions.InvalidSignature Verificarea semnăturii a eșuat: mesajul verificat nu e exact același cu cel semnat (alt text, altă ordine a câmpurilor, alte spații) sau folosești altă cheie publică. Serializează mesajul identic la semnare și la verificare. Î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.
