...
Eroare Node.js · Buffer, crypto și assert

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

Pe scurt

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ă

Greșit
JavaScript
// pornit cu: node index.js
const cheie = process.env.JWT_SECRET;
crypto.createHmac("sha256", cheie);
Corect
JavaScript
// 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

Greșit
JavaScript
// .env: JWT_SECRET=abc
console.log(process.env.JWT_SECRET); // undefined
Corect
JavaScript
// 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ă

Greșit
JavaScript
const config = require("./config.json"); // { "secret": "..." }
crypto.createHmac("sha256", config.SECRET);
Corect
JavaScript
const config = require("./config.json");
crypto.createHmac("sha256", config.secret);

Proprietățile sunt sensibile la majuscule; o cheie inexistentă dă undefined.

Repară tu

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.

Codul care dă eroarea
JavaScript
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")}`);
După reparație, programul afișează
plata:150 -> 179e8b9418dc51a3
plata:1500 -> 44bb537efde03579
Indiciu

În config.json cheia se numește hmacSecret, cu literele exact așa.

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 value
  • TypeError [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.example cu 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

← Toate erorile Node.js

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ță 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.