Error: Digest method not supported
Numele algoritmului dat lui crypto.createHash sau createHmac nu e recunoscut, de obicei o greșeală de scriere: "sha265" în loc de "sha256" sau "SHA-256" cu cratimă. Folosește un nume valid, de exemplu "sha256", "sha512" sau "md5".
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
crypto.createHash(algoritm) și crypto.createHmac(algoritm, cheie) primesc numele algoritmului de hash ca text. Node îl caută în lista de algoritmi oferită de OpenSSL; dacă nu-l găsește, aruncă Digest method not supported (codul ERR_CRYPTO_INVALID_DIGEST în unele versiuni).
Cele mai frecvente cauze sunt greșelile de scriere (sha265, sh256), forma cu cratimă din Web Crypto (SHA-256, care merge în browser cu crypto.subtle, dar nu în createHash) sau un algoritm vechi dezactivat în versiunile noi de OpenSSL. Lista completă o vezi cu crypto.getHashes(). Eroarea apare chiar la crearea obiectului, pe linia cu createHash, înainte de update sau digest.
De ce apare: cauzele frecvente
1Nume scris greșit
crypto.createHash("sha265").update(text).digest("hex");crypto.createHash("sha256").update(text).digest("hex");Numele trebuie să fie exact unul din crypto.getHashes().
2Forma din Web Crypto
crypto.createHash("SHA-256");crypto.createHash("sha256");crypto.subtle.digest din browser folosește SHA-256; createHash din Node folosește numele OpenSSL, sha256.
3Algoritm din variabilă nesetată
const alg = process.env.HASH_ALG; // ""
crypto.createHash(alg);const alg = process.env.HASH_ALG || "sha256";
crypto.createHash(alg);Un text gol nu e un algoritm valid; folosește o valoare implicită.
Repară eroarea, direct în pagină
Programul calculează amprenta SHA-256 a unor parole de test, dar dă Error: Digest method not supported. Corectează numele algoritmului, ca programul să afișeze primele 16 caractere ale fiecărei amprente.
const crypto = require("crypto");
for (const text of ["parola123", "Parola123"]) {
const amprenta = crypto.createHash("sha265").update(text).digest("hex");
console.log(`${text}: ${amprenta.slice(0, 16)}`);
}parola123: a3a2754f94b4f8c1 Parola123: 3a7306a7751a1079
Indiciu
Numele algoritmului în Node se scrie cu litere mici, fără cratimă: sha urmat de numărul de biți.
Reparația
const crypto = require("crypto");
for (const text of ["parola123", "Parola123"]) {
const amprenta = crypto.createHash("sha256").update(text).digest("hex");
console.log(`${text}: ${amprenta.slice(0, 16)}`);
}De ce merge
createHash caută algoritmul după nume, iar sha265 nu există (SHA-2 are variantele 224, 256, 384 și 512). Cu sha256 primești o amprentă de 64 de caractere hexazecimale; aici afișezi doar primele 16. Observă că cele două texte, care diferă printr-o singură literă, au amprente complet diferite: asta face un hash bun potrivit pentru verificarea integrității datelor.
Alte forme ale mesajului
Error: Invalid digest: sha265TypeError [ERR_CRYPTO_INVALID_DIGEST]: Invalid digest: sha265Error: error:0308010C:digital envelope routines::unsupported
Cum o eviți pe viitor
- Păstrează numele algoritmului într-o constantă (
const ALG = "sha256") și folosește-o peste tot. - Verifică lista cu
crypto.getHashes().includes(alg)când algoritmul vine din configurare. - Folosește algoritmi moderni:
sha256sausha512. Pentru parole,scryptsaubcrypt, nu un hash simplu.
Întrebări frecvente
Ce e eroarea 0308010C digital envelope routines unsupported?
Apare la unelte vechi (de exemplu Webpack 4) pe Node 17+, care folosesc algoritmul md4, dezactivat în OpenSSL 3. Actualizează unealta; soluția temporară e NODE_OPTIONS=--openssl-legacy-provider.
Pot folosi md5?
Merge pentru sume de control fără rol de securitate. Pentru orice ține de securitate, folosește sha256 sau mai puternic.
Erori înrudite
Error [ERR_CRYPTO_HASH_FINALIZED]: Digest already called Ai apelat digest() de două ori pe același obiect Hash sau Hmac, sau ai făcut update() după digest(). Un hash se poate finaliza o singură dată: salvează rezultatul lui digest() într-o variabilă și creează un hash nou pentru fiecare text. TypeError [ERR_INVALID_ARG_TYPE]: The "key" argument must be of type string or an instance of ArrayBuffer, Buffer, TypedArray, DataView, KeyObject, or CryptoKey. Received undefined Cheia secretă dată lui crypto.createHmac (sau unei funcții de semnare, ca la JWT) e undefined: variabila de mediu nu e setată, fișierul de configurare nu are cheia sau numele proprietății e greșit. Verifică de unde vine cheia și oprește aplicația cu un mesaj clar dacă lipsește. TypeError [ERR_UNKNOWN_ENCODING]: Unknown encoding: base-64 Numele codificării dat lui Buffer.from, toString sau unei funcții din fs nu e recunoscut de Node: de obicei e scris cu cratimă sau greșit, de exemplu "base-64" sau "utf-16". Folosește numele acceptate: "utf8", "base64", "base64url", "hex", "latin1", "utf16le", "ascii". Învață Node.js de la zero, cu exerciții la fiecare lecție
Curs Node.js: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
