...
Eroare Python · Date: JSON, text și date calendaristice

binascii.Error: Incorrect padding

Pe scurt

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

Greșit
PYTHON
import base64
token = "eyJ1c2VyIjoiYW5hIn0"
print(base64.b64decode(token))
Corect
PYTHON
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

Greșit
PYTHON
import base64
jwt = "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyIjoiYW5hIn0.semnatura"
print(base64.b64decode(jwt.split(".")[1]))
Corect
PYTHON
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ă tu

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"}.

Codul care dă eroarea
PYTHON
import base64

token = "eyJ1c2VyIjoiYW5hIn0"
date = base64.b64decode(token)
print(date.decode("utf-8"))
După reparație, programul afișează
{"user":"ana"}
Indiciu

Lungimea textului trebuie să fie multiplu de 4; completează cu =.

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/b64decode sau urlsafe_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

← Toate erorile Python

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ță 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.