...
Eroare Blockchain · Hex, bytes și numere mari

binascii.Error: Incorrect padding

Pe scurt

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

Greșit
PYTHON
import base64

semn = "SGVsbG8gYmxvY2s"
b = base64.b64decode(semn)
Corect
PYTHON
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

Greșit
PYTHON
import base64

token = "eyJ0eCI6ImFiIn0"
b = base64.b64decode(token)
Corect
PYTHON
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ă tu

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.

Codul care dă eroarea
PYTHON
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())
După reparație, programul afișează
13 Semnatura Ana
16 Semnatura Bogdan
13 Semnatura Dan
Indiciu

Lungimea unui text Base64 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

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

← Toate erorile Blockchain

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