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

javax.crypto.IllegalBlockSizeException: Input length must be multiple of 16 when decrypting with padded cipher

Pe scurt

Textul criptat pe care îl decriptezi nu mai are lungimea originală (multiplu de 16 octeți), de obicei pentru că octeții criptați au fost transformați în String cu new String(...) și înapoi. Păstrează-i ca octeți sau transformă-i cu Base64.

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

Ce înseamnă

AES criptează în blocuri de 16 octeți. Cu padding (AES/ECB/PKCS5Padding, AES/CBC/PKCS5Padding, sau simplu AES), rezultatul criptării are mereu o lungime multiplu de 16. La decriptare, dacă primești altă lungime, Java știe sigur că datele au fost stricate și aruncă IllegalBlockSizeException: Input length must be multiple of 16 when decrypting with padded cipher.

Cauza aproape mereu: octeții criptați au fost puși într-un String (new String(criptat)) ca să fie salvați sau trimiși, apoi transformați înapoi cu getBytes(). Octeții criptați nu sunt text valid, deci unele secvențe se înlocuiesc cu caracterul ? / \uFFFD, iar lungimea se schimbă. Alte cauze: datele au fost tăiate (o coloană prea scurtă în baza de date) sau ai decriptat textul Base64 fără să-l decodezi.

Varianta Input length not multiple of 16 bytes apare la NoPadding, când chiar textul pe care îl criptezi nu are o lungime multiplu de 16.

De ce apare: cauzele frecvente

1Octeți criptați trecuți prin String

Greșit
JAVA
String salvat = new String(criptat, StandardCharsets.UTF_8);
byte[] inapoi = salvat.getBytes(StandardCharsets.UTF_8);
cipher.doFinal(inapoi);
Corect
JAVA
String salvat = Base64.getEncoder().encodeToString(criptat);
byte[] inapoi = Base64.getDecoder().decode(salvat);
cipher.doFinal(inapoi);

Base64 transformă orice octeți în text și înapoi fără pierderi, deci lungimea rămâne aceeași.

2Textul Base64 decriptat direct

Greșit
JAVA
byte[] date = textBase64.getBytes();
cipher.doFinal(date);
Corect
JAVA
byte[] date = Base64.getDecoder().decode(textBase64);
cipher.doFinal(date);

Octeții textului Base64 nu sunt octeții criptați. Întâi decodezi, apoi decriptezi.

3NoPadding cu text de lungime oarecare

Greșit
JAVA
Cipher c = Cipher.getInstance("AES/ECB/NoPadding");
c.doFinal("abc".getBytes());
Corect
JAVA
Cipher c = Cipher.getInstance("AES/GCM/NoPadding"); // cu GCMParameterSpec
// sau: Cipher.getInstance("AES/CBC/PKCS5Padding") cu IV

Fără padding, modurile pe blocuri cer lungimi multiplu de 16. GCM sau un mod cu padding acceptă orice lungime.

Repară tu

Repară eroarea, direct în pagină

Programul criptează o notiță, o „salvează” ca text și apoi o decriptează, dar se oprește cu IllegalBlockSizeException: Input length must be multiple of 16 when decrypting with padded cipher. Salvează octeții criptați cu Base64 și decodează-i înainte de decriptare, ca programul să afișeze Decriptat: Parola contului: 1234.

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

public class Main {
    public static void main(String[] args) throws Exception {
        SecretKeySpec cheie = new SecretKeySpec("cheie-secreta-16".getBytes(StandardCharsets.UTF_8), "AES");
        Cipher c = Cipher.getInstance("AES");
        c.init(Cipher.ENCRYPT_MODE, cheie);
        byte[] criptat = c.doFinal("Parola contului: 1234".getBytes(StandardCharsets.UTF_8));

        String salvat = new String(criptat, StandardCharsets.UTF_8);

        byte[] citit = salvat.getBytes(StandardCharsets.UTF_8);
        c.init(Cipher.DECRYPT_MODE, cheie);
        System.out.println("Decriptat: " + new String(c.doFinal(citit), StandardCharsets.UTF_8));
    }
}
După reparație, programul afișează
Decriptat: Parola contului: 1234
Indiciu

Base64.getEncoder().encodeToString(criptat) la salvare și Base64.getDecoder().decode(salvat) la citire.

Alte forme ale mesajului

  • javax.crypto.IllegalBlockSizeException: Input length not multiple of 16 bytes
  • javax.crypto.IllegalBlockSizeException: Input length must be multiple of 8 when decrypting with padded cipher
  • javax.crypto.IllegalBlockSizeException: Data must not be longer than 245 bytes

Cum o eviți pe viitor

  • Nu transforma niciodată octeți criptați în String cu new String(...): folosește Base64 sau păstrează byte[].
  • În baza de date, salvează datele criptate ca BLOB/bytea sau ca text Base64, într-o coloană suficient de lungă.
  • Pentru criptare nouă, folosește AES/GCM/NoPadding, care acceptă orice lungime și detectează și modificările datelor.
  • Testează un drum complet: criptare, salvare, citire, decriptare.

Întrebări frecvente

De ce new String(octeti) strică datele?

Constructorul interpretează octeții ca text UTF-8. Secvențele care nu sunt UTF-8 valid se înlocuiesc cu caracterul de înlocuire, iar la getBytes() acesta devine alți 3 octeți. Informația originală se pierde.

Ce înseamnă Data must not be longer than 245 bytes?

E aceeași familie de excepții, dar la RSA: cu o cheie de 2048 de biți, poți cripta direct cel mult 245 de octeți. Pentru date mai lungi se criptează datele cu AES, iar cheia AES cu RSA.

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.