binascii.Error: Incorrect padding
Textul dat lui `base64.b64decode` nu are lungimea corectă: Base64 cere un multiplu de 4 caractere, completat la final cu `=`. Adaugă semnele lipsă (`text + "=" * (-len(text) % 4)`) sau, pentru token-uri JWT și URL-uri, folosește `base64.urlsafe_b64decode` după completare.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Base64 transformă octeți în text: fiecare grup de 3 octeți devine 4 caractere. Când datele nu se împart exact la 3, la final se adaugă unul sau două semne = („padding”), astfel încât lungimea textului să fie mereu un multiplu de 4. b64decode verifică acest lucru și, dacă lungimea nu se potrivește, ridică binascii.Error: Incorrect padding.
Cel mai des, padding-ul a fost eliminat intenționat: token-urile JWT și multe valori din URL-uri folosesc Base64 fără =. Alte cauze: textul a fost tăiat la copiere, conține spații sau linii noi, sau nu e deloc Base64 (de exemplu ai decodat ceva deja decodat). Varianta number of data characters (5) cannot be 1 more than a multiple of 4 apare când lungimea e imposibilă chiar și cu padding, adică textul e incomplet sau corupt.
De ce apare: cauzele frecvente
1Token fără padding
import base64
token = "eyJ1c2VyIjoiYW5hIn0"
print(base64.b64decode(token))import base64
token = "eyJ1c2VyIjoiYW5hIn0"
token += "=" * (-len(token) % 4)
print(base64.b64decode(token))-len(token) % 4 dă câte caractere lipsesc până la multiplul de 4, iar semnele = completează textul.
2Partea din mijloc a unui JWT
import base64
jwt = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyIjoiYW5hIn0.semnatura"
print(base64.b64decode(jwt.split(".")[1]))import base64
jwt = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyIjoiYW5hIn0.semnatura"
parte = jwt.split(".")[1]
print(base64.urlsafe_b64decode(parte + "=" * (-len(parte) % 4)))JWT folosește varianta „URL-safe” (- și _ în loc de + și /) fără padding, deci folosești urlsafe_b64decode după completare.
Repară eroarea, direct în pagină
Codul de mai jos decodează un token Base64 primit fără semnele = de la final și dă binascii.Error: Incorrect padding. Completează padding-ul înainte de decodare, ca programul să afișeze {"user":"ana"}.
import base64
token = "eyJ1c2VyIjoiYW5hIn0"
date = base64.b64decode(token)
print(date.decode("utf-8")){"user":"ana"}Indiciu
Lungimea textului trebuie să fie multiplu de 4; completează cu =.
Reparația
import base64
token = "eyJ1c2VyIjoiYW5hIn0"
token += "=" * (-len(token) % 4)
date = base64.b64decode(token)
print(date.decode("utf-8"))De ce merge
Token-ul are 19 caractere, iar Base64 cere un multiplu de 4. -len(token) % 4 dă 1, deci adăugăm un singur =, iar textul ajunge la 20 de caractere. Acum b64decode întoarce octeții originali, pe care decode("utf-8") îi transformă în text.
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
- Când primești Base64 din URL-uri sau token-uri, adaugă padding-ul înainte de decodare.
- Curăță textul de spații și linii noi (
.strip()) înainte de decodare. - Folosește perechea potrivită:
b64encode/b64decodesauurlsafe_b64encode/urlsafe_b64decode. - Nu verifica semnătura unui JWT decodându-l manual; folosește o bibliotecă (de exemplu PyJWT).
Întrebări frecvente
Pot adăuga mereu == la final, ca să fiu sigur?
Funcționează des, pentru că decodorul ignoră padding-ul în plus în modul implicit, dar e mai corect să calculezi exact câte lipsesc, cu -len(text) % 4.
De ce binascii și nu base64?
Modulul base64 folosește intern funcțiile din modulul binascii, iar excepția vine de acolo. O poți prinde cu except binascii.Error sau, mai general, cu except ValueError, pentru că e o subclasă a lui.
Erori înrudite
UnicodeDecodeError: 'utf-8' codec can't decode byte 0xe9 in position 15: invalid continuation byte Fișierul (sau datele) nu e salvat în UTF-8, ci în alt encoding, de obicei unul vechi de Windows (`cp1250`, `latin-1`) sau e un Excel salvat ca CSV. Deschide-l cu encoding-ul corect: `open("fisier.csv", encoding="cp1250")`, sau resalvează-l ca UTF-8. TypeError: a bytes-like object is required, not 'str' Amesteci bytes (`b"..."`) cu texte (`str`): de exemplu faci `split(",")` pe date binare, cauți un text într-un bytes sau scrii text într-un fișier deschis cu `"wb"`. Decodează datele cu `.decode("utf-8")` sau lucrează doar cu bytes (`b","`). json.decoder.JSONDecodeError: Expecting value: line 1 column 1 (char 0) Ai dat lui `json.loads()` / `json.load()` un text care nu e JSON: un text gol, o pagină HTML (eroare 404/500 de la un API) sau un fișier gol. „line 1 column 1 (char 0)” înseamnă că problema e chiar de la primul caracter. Afișează textul primit înainte de parsare. Î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.
