...
Eroare Java · Reflecție, module și alte API-uri

javax.crypto.BadPaddingException: Given final block not properly padded. Such issues can arise if a bad key is used during decryption.

Pe scurt

Decriptarea a mers până la ultimul bloc, dar padding-ul nu are forma corectă, de obicei pentru că decriptezi cu altă cheie (sau alt IV, alt mod) decât la criptare, ori datele au fost modificate. Folosește exact aceeași cheie, același algoritm și aceleași date.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

La criptarea cu padding PKCS5, ultimii octeți ai mesajului spun câți octeți de umplutură s-au adăugat. La decriptare, Java verifică acești octeți. Dacă nu au forma așteptată, aruncă BadPaddingException: Given final block not properly padded, iar mesajul îți dă și cea mai probabilă cauză: s-a folosit o cheie greșită.

Cauze frecvente:

  • cheia de la decriptare diferă de cea de la criptare (alt text, alt hash, un spațiu în plus, alt encoding);
  • pentru CBC, IV-ul folosit la decriptare nu e același cu cel de la criptare (dar atunci se strică de obicei doar primul bloc);
  • datele criptate au fost modificate sau tăiate;
  • algoritmul diferă: criptat cu AES/CBC/PKCS5Padding, decriptat cu AES (care înseamnă ECB).

Cu modul GCM, aceeași situație se raportează altfel: AEADBadTagException: Tag mismatch.

De ce apare: cauzele frecvente

1Altă cheie la decriptare

Greșit
JAVA
SecretKeySpec k1 = cheie("Secret-2024");
SecretKeySpec k2 = cheie("secret-2024");
// criptat cu k1, decriptat cu k2
Corect
JAVA
SecretKeySpec k = cheie("Secret-2024");
// criptat si decriptat cu aceeasi cheie k

O singură literă diferită dă o cheie complet diferită, iar blocul final decriptat devine zgomot, fără padding valid.

2Alt mod sau alt padding

Greșit
JAVA
Cipher.getInstance("AES/CBC/PKCS5Padding"); // la criptare
Cipher.getInstance("AES");                  // la decriptare
Corect
JAVA
static final String ALG = "AES/CBC/PKCS5Padding";
Cipher.getInstance(ALG); // in ambele locuri

"AES" înseamnă AES/ECB/PKCS5Padding. Modurile diferite produc rezultate diferite la decriptare.

3Cheia citită cu spații în plus

Greșit
JAVA
String cheieText = " Secret-2024\n"; // din fisier
Corect
JAVA
String cheieText = " Secret-2024\n".strip();

Spațiile și sfârșitul de rând fac parte din octeții cheii. strip() le elimină.

Repară tu

Repară eroarea, direct în pagină

Programul criptează un mesaj cu cheia din configurare, dar la decriptare folosește din greșeală altă cheie și se oprește cu BadPaddingException: Given final block not properly padded. Decriptează cu aceeași cheie ca la criptare, ca programul să afișeze Decriptat: transfer aprobat.

Codul care dă eroarea
JAVA
import java.nio.charset.StandardCharsets;
import java.security.MessageDigest;
import javax.crypto.Cipher;
import javax.crypto.spec.SecretKeySpec;

public class Main {
    static SecretKeySpec cheie(String parola) throws Exception {
        byte[] h = MessageDigest.getInstance("SHA-256").digest(parola.getBytes(StandardCharsets.UTF_8));
        return new SecretKeySpec(h, "AES");
    }

    public static void main(String[] args) throws Exception {
        Cipher c = Cipher.getInstance("AES");
        c.init(Cipher.ENCRYPT_MODE, cheie("Secret-2024"));
        byte[] criptat = c.doFinal("transfer aprobat".getBytes(StandardCharsets.UTF_8));

        c.init(Cipher.DECRYPT_MODE, cheie("secret-2024"));
        System.out.println("Decriptat: " + new String(c.doFinal(criptat), StandardCharsets.UTF_8));
    }
}
După reparație, programul afișează
Decriptat: transfer aprobat
Indiciu

Ambele apeluri init trebuie să primească aceeași cheie.

Alte forme ale mesajului

  • javax.crypto.AEADBadTagException: Tag mismatch
  • javax.crypto.AEADBadTagException: Tag mismatch!
  • javax.crypto.BadPaddingException: Decryption error

Cum o eviți pe viitor

  • Ține cheia, algoritmul complet (AES/GCM/NoPadding) și parametrii (IV, sare) într-un singur loc, folosit și la criptare, și la decriptare.
  • Salvează IV-ul împreună cu datele criptate (de exemplu IV + text criptat, în Base64).
  • Curăță cheile citite din fișiere (strip()) și decodează-le corect din Base64.
  • Nu afișa detaliile excepției utilizatorului: în aplicații web, mesajele de padding pot ajuta un atacator.

Întrebări frecvente

De ce uneori decriptarea cu cheia greșită nu dă eroare, ci text ciudat?

Din întâmplare, blocul final decriptat poate arăta ca un padding valid, iar atunci primești text fără sens în loc de excepție. Modul GCM previne asta: verifică un tag de autenticitate și refuză orice date sau chei greșite.

Ce înseamnă Decryption error?

Este mesajul pentru RSA: datele au fost decriptate cu o cheie privată care nu corespunde cheii publice folosite la criptare, sau datele au fost modificate.

Erori înrudite

← Toate erorile Java

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ță Java de la zero, cu exerciții la fiecare lecție

Curs Java: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.