Error: Cannot find module '/app/node_modules/formatare/dist/index.js'. Please verify that the package.json has a valid "main" entry
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
// node_modules/formatare/package.json
{ "name": "formatare", "main": "dist/index.js" }
// dar există doar src/index.js# î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
{ "main": "index.js" } // fișierul e acum în lib/index.js{ "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
npm install github:firma/formatare
# repo-ul are .gitignore cu dist/// 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ă 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.
const { formatLei } = require("formatare");
console.log(formatLei(1234.5));1234.50 lei
Indiciu
Uită-te ce fișiere are pachetul: require("formatare/src/index.js") ocolește câmpul main.
Reparația
// main din package.json arată spre dist/, care nu există încă: încărcăm direct sursa
const { formatLei } = require("formatare/src/index.js");
console.log(formatLei(1234.5));De ce merge
require("formatare") citește package.json-ul pachetului și urmează main, adică dist/index.js, care nu există. Cu o cale în interiorul pachetului (formatare/src/index.js) Node încarcă direct fișierul, fără să se uite la main. Merge pentru că pachetul nu are câmpul exports, care ar bloca astfel de căi. Reparația definitivă e în pachet: build-ul care creează dist/ sau main corectat.
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" entryError: Cannot find module '/home/ana/proiect/packages/ui/dist/index.js'. Please verify that the package.json has a valid "main" entrycode: '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 apoinpm install ./formatare-1.0.0.tgzîntr-un proiect gol. - Dacă
mainarată spredist/, pune build-ul înpreparesauprepublishOnly. - După ce muți fișiere, caută
mainșiexportsînpackage.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
Error: Cannot find module 'lodash' Pachetul cerut nu este instalat în node_modules: ai uitat npm install, l-ai instalat în alt dosar sau numele e scris greșit. Rulează npm install lodash (sau npm install dacă e deja în package.json) în dosarul proiectului, ori folosește o funcție inclusă în Node. Error: Cannot find module './calcul' Node nu găsește fișierul pe care îl ceri cu require: calea e scrisă greșit, fișierul are alt nume sau e în alt dosar. Verifică numele exact al fișierului și calea relativă față de fișierul care face require, de exemplu require("./calcule") sau require("./lib/calcule"). Error [ERR_PACKAGE_PATH_NOT_EXPORTED]: Package subpath './lib/format.js' is not defined by "exports" in /app/node_modules/preturi/package.json Pachetul are câmpul "exports" în package.json, care spune exact ce căi au voie să fie importate, iar calea ta internă (de exemplu pachet/lib/format.js) nu e în listă. Importă pachetul prin calea publică (de obicei doar numele lui) sau printr-o cale listată în "exports". Î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.
