Error: Cannot find module 'express'
Node nu găsește pachetul express în /app/node_modules, deci aplicația se oprește la pornire. Ori lipsește RUN npm install din Dockerfile, ori ai montat codul de pe calculator peste /app (-v ~/api:/app) și ai ascuns node_modules din imagine. Instalează pachetele în imagine sau într-un volum separat pentru /app/node_modules.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
require("express") caută pachetul în node_modules, începând din folderul fișierului. Dacă nu-l găsește, Node aruncă Cannot find module 'express' cu code: 'MODULE_NOT_FOUND', iar Require stack arată fișierul care l-a cerut (/app/server.js).
În Docker, două cauze domină:
- npm install lipsă în Dockerfile, deci imaginea are codul, dar nu și dependențele;
- bind mount peste /app: imaginea are
node_modules, dar-v ~/api:/apppune folderul de pe calculator (fărănode_modules, sau cu unul instalat pe macOS/Windows) peste tot/app, inclusiv peste pachete.
Diferența față de Cannot find module '/app/server.js': acolo lipsește chiar fișierul aplicației; aici lipsește un pachet npm.
De ce apare: cauzele frecvente
1Bind mount care ascunde node_modules
docker run -d -p 3000:3000 -v ~/api:/app api:1.0docker run --rm -v ~/api:/app -v api-modules:/app/node_modules -w /app node:20-alpine npm install
docker run -d -p 3000:3000 -v ~/api:/app -v api-modules:/app/node_modules api:1.0Volumul separat ține pachetele instalate pentru Linux, iar bind mount-ul nu le mai acoperă.
2Dockerfile fără npm install
FROM node:20-alpine
WORKDIR /app
COPY . .
CMD ["node", "server.js"]FROM node:20-alpine
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
CMD ["node", "server.js"]Pachetele din package.json se instalează în imagine la build.
3Pachetul lipsește din package.json
npm install express # doar pe calculator, fără să salvezi package.jsonnpm install express --save
# apoi docker build din nouImaginea instalează doar ce scrie în package.json și package-lock.json.
Repară eroarea, direct în pagină
În ~/api, imaginea api:1.0 e construită corect (cu npm install), dar ai pornit-o cu codul montat, -v ~/api:/app, ca să vezi modificările fără rebuild. Containerul api cade cu Cannot find module 'express'. Instalează pachetele în volumul api-modules și pornește din nou api pe portul 3000, cu codul montat în /app și volumul în /app/node_modules.
Indiciu
Rulează npm install într-un container temporar care montează codul și volumul api-modules, apoi pornește api cu ambele montări.
Reparația
docker rm -f api
docker run --rm -v ~/api:/app -v api-modules:/app/node_modules -w /app node:20-alpine npm install
docker run -d --name api -p 3000:3000 -v ~/api:/app -v api-modules:/app/node_modules api:1.0
curl -s localhost:3000Salut din APIDe ce merge
Bind mount-ul punea peste /app folderul de pe calculator, fără node_modules, deci pachetele din imagine nu se mai vedeau. Containerul temporar instalează express în volumul api-modules. Montat pe /app/node_modules, volumul are prioritate față de bind mount, așa că require("express") găsește pachetul, iar codul rămâne montat de pe calculator.
Alte forme ale mesajului
Error: Cannot find module 'dotenv'node:internal/modules/cjs/loader:1228 throw err; ^ Error: Cannot find module 'express' Require stack: - /app/server.jsError [ERR_MODULE_NOT_FOUND]: Cannot find package 'express' imported from /app/server.js
Cum o eviți pe viitor
Instalează mereu dependențele în Dockerfile (COPY package*.json ./ + RUN npm ci sau npm install) și pune node_modules în .dockerignore. În dezvoltare, când montezi codul, dă-i lui /app/node_modules un volum separat. Nu copia în container un node_modules instalat pe macOS sau Windows: pachetele native nu merg pe Linux.
Întrebări frecvente
Imaginea merge fără -v, dar cu -v ~/api:/app nu. De ce?
Bind mount-ul înlocuiește tot conținutul lui /app din imagine cu folderul de pe calculator. Dacă acolo nu există node_modules, pachetele instalate la build devin invizibile.
De ce să nu instalez pachetele pe calculator și să le montez?
Pachetele cu cod nativ (de exemplu bcrypt, sharp) sunt compilate pentru sistemul pe care le instalezi. Cele de pe macOS sau Windows nu pornesc în containerul Linux.
Erori înrudite
Error: Cannot find module '/app/server.js' Node a pornit în container, dar fișierul din CMD nu e în WORKDIR-ul imaginii: codul a fost copiat în alt folder, nu a fost copiat deloc sau un volum îl ascunde. Aliniază WORKDIR, COPY și CMD (de exemplu WORKDIR /app, COPY . ., CMD ["node", "server.js"]) și reconstruiește imaginea. npm error enoent Could not read package.json: Error: ENOENT: no such file or directory, open '/app/package.json' RUN npm install rulează într-un folder din imagine unde nu există package.json: lipsește COPY package*.json ./ înaintea instalării sau WORKDIR e altul. Copiază întâi package.json și package-lock.json în WORKDIR, apoi rulează npm install. docker: Error response from daemon: invalid mount config for type "bind": bind source path does not exist: /home/ana/site Cu --mount type=bind (sau bind mount-uri în compose cu sintaxa lungă), folderul sau fișierul de pe calculator trebuie să existe deja, iar calea dată nu există: e scrisă greșit, e relativă față de alt folder sau n-ai creat-o. Corectează calea (de obicei cu $(pwd) sau $HOME) ori creează folderul înainte. Containerul se oprește imediat după pornire: Exited (1) Exited (1) înseamnă că aplicația din container a pornit și a crăpat cu o eroare. Citește motivul cu docker logs nume: de obicei e o cale greșită în CMD, un fișier sau un modul lipsă, o variabilă de mediu obligatorie nesetată sau o eroare în cod. Învață Docker de la zero, cu exerciții la fiecare lecție
Curs Docker: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
