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

java.security.InvalidKeyException: Invalid AES key length: 10 bytes

Pe scurt

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.

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

Ce înseamnă

AES lucrează cu chei de 128, 192 sau 256 de biți, adică 16, 24 sau 32 de octeți. new SecretKeySpec(octeti, "AES") acceptă orice lungime, dar la cipher.init(...) cheia e verificată, iar dacă are altă lungime primești InvalidKeyException: Invalid AES key length: N bytes, unde N este lungimea reală.

Cauza clasică: cheia e făcută dintr-o parolă sau dintr-un text oarecare cu getBytes(). Lungimea depinde atunci de text și chiar de caracterele folosite: o literă cu diacritice ocupă 2 octeți în UTF-8.

Corect este ca o parolă să fie transformată în cheie printr-o funcție de derivare (PBKDF2WithHmacSHA256, cu sare și multe iterații) sau ca cheia să fie generată aleator cu KeyGenerator.getInstance("AES") și păstrată în siguranță (de exemplu în Base64, într-un seif de secrete).

De ce apare: cauzele frecvente

1Parola folosită direct drept cheie

Greșit
JAVA
SecretKeySpec cheie = new SecretKeySpec("parola1234".getBytes(), "AES");
Corect
JAVA
byte[] h = MessageDigest.getInstance("SHA-256")
    .digest("parola1234".getBytes(StandardCharsets.UTF_8));
SecretKeySpec cheie = new SecretKeySpec(h, "AES"); // 32 octeti

SHA-256 dă mereu 32 de octeți, deci o cheie AES-256 validă. În producție folosește PBKDF2 cu sare, nu un singur hash.

2Cheie generată corect

Greșit
JAVA
SecretKeySpec cheie = new SecretKeySpec("cheie".getBytes(), "AES");
Corect
JAVA
KeyGenerator g = KeyGenerator.getInstance("AES");
g.init(256);
SecretKey cheie = g.generateKey();

KeyGenerator produce o cheie aleatoare, de lungimea cerută.

3Cheia păstrată ca text Base64

Greșit
JAVA
byte[] k = cheieText.getBytes(); // "q83vEjRWeJA=..."
Corect
JAVA
byte[] k = Base64.getDecoder().decode(cheieText);

O cheie salvată în Base64 trebuie decodată. getBytes() dă octeții textului, nu ai cheii, deci o lungime greșită.

Repară tu

Repară eroarea, direct în pagină

Programul criptează și decriptează un mesaj cu AES, dar cheia e făcută direct din parolă și programul se oprește cu InvalidKeyException: Invalid AES key length: 10 bytes. Calculează cheia ca SHA-256 al parolei (32 de octeți), ca programul să afișeze Cheie: 32 octeti și Decriptat: salut.

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 {
        String parola = "parola1234";
        byte[] octetiCheie = parola.getBytes(StandardCharsets.UTF_8);
        System.out.println("Cheie: " + octetiCheie.length + " octeti");
        SecretKeySpec cheie = new SecretKeySpec(octetiCheie, "AES");

        Cipher c = Cipher.getInstance("AES");
        c.init(Cipher.ENCRYPT_MODE, cheie);
        byte[] criptat = c.doFinal("salut".getBytes(StandardCharsets.UTF_8));
        c.init(Cipher.DECRYPT_MODE, cheie);
        System.out.println("Decriptat: " + new String(c.doFinal(criptat), StandardCharsets.UTF_8));
    }
}
După reparație, programul afișează
Cheie: 32 octeti
Decriptat: salut
Indiciu

MessageDigest.getInstance("SHA-256").digest(parola.getBytes(StandardCharsets.UTF_8))

Alte forme ale mesajului

  • java.security.InvalidKeyException: Invalid AES key length: 20 bytes
  • java.security.InvalidKeyException: Illegal key size
  • java.lang.IllegalArgumentException: Empty key

Cum o eviți pe viitor

  • Nu folosi niciodată o parolă direct drept cheie: derivă cheia cu SecretKeyFactory.getInstance("PBKDF2WithHmacSHA256").
  • Generează cheile cu KeyGenerator și păstrează-le în Base64 sau într-un seif de secrete, nu în cod.
  • Verifică lungimea cheii la pornire: cheie.length trebuie să fie 16, 24 sau 32.
  • Pentru criptare nouă, alege AES/GCM/NoPadding cu un IV aleator pentru fiecare mesaj.

Întrebări frecvente

Ce înseamnă Illegal key size?

Apare pe versiuni vechi de Java 8 care limitau cheile AES la 128 de biți, iar o cheie de 256 era refuzată. Soluția e o versiune de Java actualizată (limita a fost scoasă în 8u161).

De ce lungimea în octeți e diferită de numărul de caractere?

getBytes() codifică textul, implicit în UTF-8: literele simple ocupă un octet, iar ș, ț, ă câte doi. Numără întotdeauna octeții (octeti.length), nu caracterele.

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.