java.security.NoSuchAlgorithmException: SHA-3 MessageDigest not available
Numele algoritmului dat lui MessageDigest.getInstance (sau Cipher, KeyGenerator) nu există sub forma scrisă. Folosește numele standard exact: SHA-256, SHA-512, SHA3-256, MD5.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Clasele de securitate din Java (MessageDigest, Cipher, Mac, KeyGenerator, SecureRandom) caută algoritmul după nume, ca text, printre furnizorii instalați. Dacă nu găsesc niciunul cu numele cerut, aruncă excepția verificată NoSuchAlgorithmException, cu numele căutat și tipul serviciului: SHA-3 MessageDigest not available.
Cel mai des, numele e aproape bun: SHA-3 (corect: SHA3-256 sau SHA3-512, pentru că SHA-3 are mai multe lungimi), SHA_256 (corect: SHA-256), HmacSha256 la MessageDigest în loc de Mac. Literele mari și mici nu contează, dar cratimele și cifrele da. Unele aliasuri, precum SHA256, sunt acceptate doar de anumite versiuni.
Numele standard sunt în documentația „Java Security Standard Algorithm Names”. Folosește-le exact și ține-le într-o constantă, ca să nu le repeți în cod.
De ce apare: cauzele frecvente
1SHA-3 fără lungime
MessageDigest md = MessageDigest.getInstance("SHA-3");MessageDigest md = MessageDigest.getInstance("SHA3-256");SHA-3 e o familie; numele standard include lungimea rezultatului.
2Liniuță de jos în loc de cratimă
MessageDigest md = MessageDigest.getInstance("SHA_256");MessageDigest md = MessageDigest.getInstance("SHA-256");Numele standard folosește cratimă.
3Algoritm cerut de la serviciul greșit
MessageDigest md = MessageDigest.getInstance("HmacSHA256");Mac mac = Mac.getInstance("HmacSHA256");HMAC folosește o cheie, deci e un Mac, nu un MessageDigest.
Repară eroarea, direct în pagină
Programul calculează amprenta SHA-3 a unui fișier de configurare (aici, un text), dar se oprește cu NoSuchAlgorithmException: SHA-3 MessageDigest not available. Folosește numele standard pentru SHA-3 cu 256 de biți, ca programul să afișeze Lungime amprenta: 32 octeti.
import java.nio.charset.StandardCharsets;
import java.security.MessageDigest;
public class Main {
public static void main(String[] args) throws Exception {
MessageDigest md = MessageDigest.getInstance("SHA-3");
byte[] amprenta = md.digest("port=8080".getBytes(StandardCharsets.UTF_8));
System.out.println("Lungime amprenta: " + amprenta.length + " octeti");
}
}Lungime amprenta: 32 octeti
Indiciu
Numele standard este SHA3-256.
Reparația
import java.nio.charset.StandardCharsets;
import java.security.MessageDigest;
public class Main {
public static void main(String[] args) throws Exception {
MessageDigest md = MessageDigest.getInstance("SHA3-256");
byte[] amprenta = md.digest("port=8080".getBytes(StandardCharsets.UTF_8));
System.out.println("Lungime amprenta: " + amprenta.length + " octeti");
}
}De ce merge
SHA-3 este o familie de algoritmi cu lungimi diferite, iar Java îi înregistrează sub nume precise, ca SHA3-256. Cu numele exact, getInstance găsește algoritmul, iar digest întoarce amprenta de 256 de biți, adică 32 de octeți, indiferent de lungimea textului.
Alte forme ale mesajului
java.security.NoSuchAlgorithmException: SHA_256 MessageDigest not availablejava.security.NoSuchAlgorithmException: SHA3 MessageDigest not availablejava.security.NoSuchAlgorithmException: HmacSHA256 MessageDigest not availableerror: unreported exception NoSuchAlgorithmException; must be caught or declared to be thrown
Cum o eviți pe viitor
- Copiază numele algoritmilor din documentația oficială, nu din memorie.
- Ține numele într-o constantă (
static final String HASH = "SHA-256";). - Pentru parole, nu folosi un simplu hash: folosește un algoritm dedicat, precum PBKDF2 sau bcrypt.
- Scrie un test care calculează hash-ul unui text cunoscut și compară rezultatul.
Întrebări frecvente
De ce trebuie să tratez excepția, deși numele e corect?
Pentru că NoSuchAlgorithmException e verificată: compilatorul nu știe dacă textul e corect. Fie o prinzi, fie declari throws.
Cât de lung e un hash SHA-256?
32 de octeți, adică 64 de caractere în hexazecimal. SHA-512 are 64 de octeți.
Erori înrudite
error: unreported exception Exception; must be caught or declared to be thrown Apelezi o metodă care poate arunca o excepție verificată (checked), iar codul tău nici nu o prinde, nici nu o declară. Pune apelul într-un try/catch sau adaugă throws NumeExceptie la metoda care face apelul. 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(). java.lang.NoSuchMethodException: Main$Produs.<init>() Codul care creează obiecte prin reflecție (getDeclaredConstructor().newInstance(), Jackson, JPA/Hibernate, framework-uri) caută un constructor fără parametri, iar clasa ta nu are. Adaugă un constructor gol: public Produs() { }. Î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.
