javax.crypto.IllegalBlockSizeException: Input length must be multiple of 16 when decrypting with padded cipher
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
String salvat = new String(criptat, StandardCharsets.UTF_8);
byte[] inapoi = salvat.getBytes(StandardCharsets.UTF_8);
cipher.doFinal(inapoi);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
byte[] date = textBase64.getBytes();
cipher.doFinal(date);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
Cipher c = Cipher.getInstance("AES/ECB/NoPadding");
c.doFinal("abc".getBytes());Cipher c = Cipher.getInstance("AES/GCM/NoPadding"); // cu GCMParameterSpec
// sau: Cipher.getInstance("AES/CBC/PKCS5Padding") cu IVFără padding, modurile pe blocuri cer lungimi multiplu de 16. GCM sau un mod cu padding acceptă orice lungime.
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.
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));
}
}Decriptat: Parola contului: 1234
Indiciu
Base64.getEncoder().encodeToString(criptat) la salvare și Base64.getDecoder().decode(salvat) la citire.
Reparația
import java.nio.charset.StandardCharsets;
import java.util.Base64;
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 = Base64.getEncoder().encodeToString(criptat);
byte[] citit = Base64.getDecoder().decode(salvat);
c.init(Cipher.DECRYPT_MODE, cheie);
System.out.println("Decriptat: " + new String(c.doFinal(citit), StandardCharsets.UTF_8));
}
}De ce merge
Textul de 21 de octeți devine, criptat cu padding, 32 de octeți. Trecuți prin new String(...) și înapoi prin getBytes(), octeții care nu formau UTF-8 valid au fost înlocuiți și au rezultat alți 62 de octeți, care nu mai sunt multiplu de 16. Base64 transformă cei 32 de octeți în text și îi redă exact la decodare, deci decriptarea primește datele originale. Cheia scrisă în cod e doar pentru exercițiu.
Alte forme ale mesajului
javax.crypto.IllegalBlockSizeException: Input length not multiple of 16 bytesjavax.crypto.IllegalBlockSizeException: Input length must be multiple of 8 when decrypting with padded cipherjavax.crypto.IllegalBlockSizeException: Data must not be longer than 245 bytes
Cum o eviți pe viitor
- Nu transforma niciodată octeți criptați în
Stringcunew String(...): folosește Base64 sau păstreazăbyte[]. - În baza de date, salvează datele criptate ca
BLOB/byteasau 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
javax.crypto.BadPaddingException: Given final block not properly padded. Such issues can arise if a bad key is used during decryption. 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. java.security.InvalidKeyException: Invalid AES key length: 10 bytes O cheie AES trebuie să aibă exact 16, 24 sau 32 de octeți, iar tu ai dat alt număr, de obicei pentru că ai folosit direct o parolă ("parola1234".getBytes()). Derivă cheia din parolă (PBKDF2 sau, în exemple simple, SHA-256) sau generează-o cu KeyGenerator. java.lang.IllegalArgumentException: Illegal base64 character 2d Base64.getDecoder() a întâlnit un caracter care nu face parte din alfabetul Base64 standard; 2d e codul hexazecimal pentru -, iar 5f pentru _, adică text encodat în varianta URL-safe (ca în tokenurile JWT). Folosește Base64.getUrlDecoder() sau, pentru spații și rânduri noi, getMimeDecoder(). Î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.
