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

java.security.NoSuchAlgorithmException: SHA-3 MessageDigest not available

Pe scurt

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

Greșit
JAVA
MessageDigest md = MessageDigest.getInstance("SHA-3");
Corect
JAVA
MessageDigest md = MessageDigest.getInstance("SHA3-256");

SHA-3 e o familie; numele standard include lungimea rezultatului.

2Liniuță de jos în loc de cratimă

Greșit
JAVA
MessageDigest md = MessageDigest.getInstance("SHA_256");
Corect
JAVA
MessageDigest md = MessageDigest.getInstance("SHA-256");

Numele standard folosește cratimă.

3Algoritm cerut de la serviciul greșit

Greșit
JAVA
MessageDigest md = MessageDigest.getInstance("HmacSHA256");
Corect
JAVA
Mac mac = Mac.getInstance("HmacSHA256");

HMAC folosește o cheie, deci e un Mac, nu un MessageDigest.

Repară tu

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.

Codul care dă eroarea
JAVA
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");
    }
}
După reparație, programul afișează
Lungime amprenta: 32 octeti
Indiciu

Numele standard este SHA3-256.

Alte forme ale mesajului

  • java.security.NoSuchAlgorithmException: SHA_256 MessageDigest not available
  • java.security.NoSuchAlgorithmException: SHA3 MessageDigest not available
  • java.security.NoSuchAlgorithmException: HmacSHA256 MessageDigest not available
  • error: 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

← 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.