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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
crypto.createHmac(algoritm, cheie) semnează date cu o cheie secretă. Cheia trebuie să fie text sau date binare; mesajul îți spune că a primit undefined, deci variabila cu secretul e goală.
Cauza tipică: cheia se citește din process.env.JWT_SECRET sau din config.json, dar variabila de mediu nu e setată pe acel calculator, fișierul .env nu e încărcat, sau proprietatea are alt nume (config.SECRET în loc de config.secret). Același tip de eroare apare la crypto.createCipheriv sau la librării de JWT, unde mesajul e de obicei secretOrPrivateKey must have a value.
Nu pune cheia direct în cod ca să scapi de eroare: secretele stau în variabile de mediu sau în configurări care nu ajung în Git.
De ce apare: cauzele frecvente
1Variabila de mediu nu e setată
// pornit cu: node index.js
const cheie = process.env.JWT_SECRET;
crypto.createHmac("sha256", cheie);// pornit cu: JWT_SECRET=... node index.js
const cheie = process.env.JWT_SECRET;
if (!cheie) throw new Error("Lipsește JWT_SECRET");
crypto.createHmac("sha256", cheie);Variabilele de mediu nesetate sunt undefined. Verificarea la pornire îți dă un mesaj clar în locul unei erori criptice.
2Fișierul .env nu e încărcat
// .env: JWT_SECRET=abc
console.log(process.env.JWT_SECRET); // undefined// node --env-file=.env index.js
console.log(process.env.JWT_SECRET.length);Node nu citește singur fișierul .env; îl încarci cu --env-file (Node 20.6+) sau cu un pachet ca dotenv.
3Numele proprietății diferă
const config = require("./config.json"); // { "secret": "..." }
crypto.createHmac("sha256", config.SECRET);const config = require("./config.json");
crypto.createHmac("sha256", config.secret);Proprietățile sunt sensibile la majuscule; o cheie inexistentă dă undefined.
Repară eroarea, direct în pagină
Programul semnează mesaje cu HMAC folosind cheia din config.json, dar dă TypeError [ERR_INVALID_ARG_TYPE]: The "key" argument must be... Received undefined, pentru că citește o proprietate care nu există. Uită-te în config.json, citește cheia corectă și oprește programul cu un mesaj clar dacă lipsește, ca programul să afișeze semnăturile scurte.
const crypto = require("crypto");
const config = require("./config.json");
const cheie = config.secret;
function semneaza(mesaj) {
return crypto.createHmac("sha256", cheie).update(mesaj).digest("hex").slice(0, 16);
}
console.log(`plata:150 -> ${semneaza("plata:150")}`);
console.log(`plata:1500 -> ${semneaza("plata:1500")}`);plata:150 -> 179e8b9418dc51a3 plata:1500 -> 44bb537efde03579
Indiciu
În config.json cheia se numește hmacSecret, cu literele exact așa.
Reparația
const crypto = require("crypto");
const config = require("./config.json");
const cheie = config.hmacSecret;
if (!cheie) throw new Error("Lipsește hmacSecret din config.json");
function semneaza(mesaj) {
return crypto.createHmac("sha256", cheie).update(mesaj).digest("hex").slice(0, 16);
}
console.log(`plata:150 -> ${semneaza("plata:150")}`);
console.log(`plata:1500 -> ${semneaza("plata:1500")}`);De ce merge
config.secret nu există în fișier, deci cheie este undefined, iar createHmac refuză o cheie care nu e text sau date binare. Cu config.hmacSecret primești cheia reală. Verificarea if (!cheie) throw ... mută problema la pornire, cu un mesaj care spune exact ce lipsește, în loc de o eroare criptică la prima semnare. Într-o aplicație reală cheia ar veni dintr-o variabilă de mediu, nu dintr-un fișier urcat în Git.
Alte forme ale mesajului
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 type number (12345)Error: secretOrPrivateKey must have a valueTypeError [ERR_INVALID_ARG_TYPE]: The "key" argument must be of type string or an instance of Buffer, TypedArray, DataView, or KeyObject. Received undefined
Cum o eviți pe viitor
- Citește toate secretele la pornirea aplicației și oprește-o imediat cu un mesaj clar dacă lipsește vreunul.
- Ține un fișier
.env.examplecu numele variabilelor necesare, fără valori reale. - Nu pune secrete în cod și nu urca
.envîn Git. - Pornește aplicația cu
node --env-file=.env index.jsîn dezvoltare.
Întrebări frecvente
De ce merge local, dar nu pe server?
Pe server variabila de mediu nu e setată. Configureaz-o în panoul platformei de găzduire, în serviciul systemd sau în docker run -e.
Pot pune o cheie implicită în cod, pentru dezvoltare?
E riscant: o cheie implicită ajunge ușor în producție, iar oricine vede codul poate semna date în numele aplicației. Mai sigur e să oprești aplicația dacă cheia lipsește.
Erori înrudite
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". TypeError [ERR_INVALID_ARG_TYPE]: The "path" argument must be of type string or an instance of Buffer or URL. Received undefined Ai dat unei funcții din fs sau path o cale care este undefined, nu un text. De obicei vine din process.argv[2] lipsă, o proprietate scrisă greșit sau o variabilă de mediu nesetată. Verifică variabila și pune o valoare implicită. 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. Î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.
