...
Eroare Node.js · Module CommonJS: require și module.exports

Error: Cannot find module '/app/node_modules/formatare/dist/index.js'. Please verify that the package.json has a valid "main" entry

Pe scurt

Pachetul există în node_modules, dar câmpul "main" din package.json-ul lui arată spre un fișier care nu există (de obicei un build care n-a fost făcut). Repară "main" ca să indice fișierul real sau rulează build-ul pachetului; până atunci poți încărca direct fișierul existent.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Mesajul are două părți. Cannot find module '/app/node_modules/formatare/dist/index.js' îți spune ce fișier a căutat Node, cu cale absolută. Please verify that the package.json has a valid "main" entry îți spune de unde a luat calea: din câmpul main al pachetului.

Deci Node a găsit pachetul (dosarul node_modules/formatare există), a citit package.json, a urmat main și acolo nu era nimic. Spre deosebire de Cannot find module 'lodash', nu lipsește pachetul, ci fișierul de intrare al lui.

Apare des la pachetele proprii dintr-un monorepo sau instalate din Git (npm install github:...), unde main arată spre dist/, dar dist/ se generează abia la build și nu e pus în repo. Mai apare când cineva mută index.js în lib/ și uită să schimbe main. Uită-te în node_modules/<pachet>/ și compară ce fișiere există cu ce scrie la main.

De ce apare: cauzele frecvente

1Pachet propriu fără build

Greșit
JavaScript
// node_modules/formatare/package.json
{ "name": "formatare", "main": "dist/index.js" }
// dar există doar src/index.js
Corect
JavaScript
# în dosarul pachetului
npm run build   # generează dist/index.js
# sau, fără build:
{ "name": "formatare", "main": "src/index.js" }

main trebuie să indice un fișier care există după instalare. Dacă dist/ apare doar după build, build-ul trebuie rulat (de exemplu în scriptul prepare).

2Fișierul a fost mutat, main a rămas vechi

Greșit
JavaScript
{ "main": "index.js" }   // fișierul e acum în lib/index.js
Corect
JavaScript
{ "main": "lib/index.js" }

Node nu caută prin dosare: urmează exact calea din main. După o reorganizare, actualizează și package.json.

3Pachet instalat din Git fără fișierele generate

Greșit
JavaScript
npm install github:firma/formatare
# repo-ul are .gitignore cu dist/
Corect
JavaScript
// package.json-ul pachetului
"scripts": { "prepare": "npm run build" }

La instalarea din Git, npm rulează scriptul prepare, deci build-ul se face automat și dist/ există.

Repară tu

Repară eroarea, direct în pagină

Pachetul local formatare din node_modules are în package.json câmpul "main": "dist/index.js", dar build-ul n-a fost făcut niciodată: codul există doar în src/index.js. Până se repară pachetul, încarcă direct fișierul care există, ca programul să afișeze prețul formatat.

Codul care dă eroarea
JavaScript
const { formatLei } = require("formatare");

console.log(formatLei(1234.5));
După reparație, programul afișează
1234.50 lei
Indiciu

Uită-te ce fișiere are pachetul: require("formatare/src/index.js") ocolește câmpul main.

Alte forme ale mesajului

  • Error: Cannot find module '/app/node_modules/pachet/lib/index.js'. Please verify that the package.json has a valid "main" entry
  • Error: Cannot find module '/home/ana/proiect/packages/ui/dist/index.js'. Please verify that the package.json has a valid "main" entry
  • code: 'MODULE_NOT_FOUND', path: '/app/node_modules/formatare/package.json', requestPath: 'formatare'

Cum o eviți pe viitor

  • Când scrii un pachet, testează-l instalat, nu doar din dosarul lui: npm pack și apoi npm install ./formatare-1.0.0.tgz într-un proiect gol.
  • Dacă main arată spre dist/, pune build-ul în prepare sau prepublishOnly.
  • După ce muți fișiere, caută main și exports în package.json.
  • În monorepo, rulează build-ul pachetelor înainte de aplicația care le folosește.

Întrebări frecvente

Ajută să șterg node_modules și să reinstalez?

Doar dacă instalarea a fost întreruptă. Dacă pachetul publicat chiar are main greșit sau nu conține dist/, reinstalarea aduce exact același conținut. Verifică întâi ce fișiere există în node_modules/<pachet>/.

E aceeași eroare ca Cannot find module 'lodash'?

Nu. Acolo lipsește tot pachetul (nu e instalat). Aici pachetul e instalat, dar fișierul indicat de main lipsește. Se vede din cale: e absolută și se termină cu fișierul din main.

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.