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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
node server.js transformă calea relativă în una absolută pornind din folderul curent al procesului, adică din WORKDIR. Mesajul Cannot find module '/app/server.js' (cu code: 'MODULE_NOT_FOUND' și requireStack: []) înseamnă că fișierul principal lipsește de acolo, nu că lipsește un pachet npm.
Containerul iese imediat cu codul 1, iar stiva o vezi cu docker logs nume. Dacă requireStack e gol, e chiar fișierul de pornire; dacă are elemente, un require din cod nu găsește un fișier al tău.
Cauzele: COPY într-un folder diferit de WORKDIR (de exemplu /usr/src/app din tutoriale vechi), fișierul principal are alt nume (index.js, src/server.js), .dockerignore îl exclude, sau un bind mount de dezvoltare montează alt folder peste /app.
De ce apare: cauzele frecvente
1COPY și WORKDIR diferite
WORKDIR /app
COPY server.js /usr/src/app/
CMD ["node", "server.js"]WORKDIR /app
COPY server.js .
CMD ["node", "server.js"]node caută server.js în WORKDIR. Fișierul trebuie copiat acolo.
2Fișierul principal e în subfolder
COPY . .
CMD ["node", "server.js"]
# codul e în src/server.jsCOPY . .
CMD ["node", "src/server.js"]Calea din CMD trebuie să corespundă structurii proiectului copiat.
3Volum montat peste /app
docker run -v $(pwd)/public:/app api:1.0docker run -v $(pwd):/app -v /app/node_modules api:1.0Montezi tot proiectul (cu server.js), iar volumul anonim păstrează node_modules din imagine.
Repară eroarea, direct în pagină
În ~/api, Dockerfile-ul are WORKDIR /app, dar copiază server.js în /usr/src/app/, iar containerul se oprește cu Error: Cannot find module '/app/server.js'. Repară Dockerfile-ul, reconstruiește api:1.0 și rulează containerul api, care trebuie să afișeze API pornit și să iasă cu codul 0.
Indiciu
Destinația din COPY trebuie să fie WORKDIR-ul (. sau /app/).
Reparația
FROM node:20-alpine
WORKDIR /app
COPY server.js .
CMD ["node", "server.js"]docker build -t api:1.0 .
docker run --name api api:1.0API pornit pe portul 3000De ce merge
Node rezolvă server.js din CMD față de WORKDIR, adică /app/server.js. Fișierul fusese copiat în /usr/src/app, deci lipsea din /app, iar procesul ieșea imediat cu codul 1. Cu COPY server.js ., fișierul ajunge în WORKDIR, iar containerul pornit din imaginea reconstruită rulează scriptul și se termină cu 0. Containerele vechi rămân pe imaginea veche, de aceea rebuild-ul e obligatoriu.
Alte forme ale mesajului
Error: Cannot find module '/usr/src/app/index.js'Error: Cannot find module '/app/dist/main.js'node:internal/modules/cjs/loader:1228 throw err; ^ Error: Cannot find module '/app/server.js'
Cum o eviți pe viitor
Folosește același folder în tot Dockerfile-ul: WORKDIR /app, apoi COPY cu destinația . și CMD cu căi relative față de el. Verifică imaginea după build cu docker run --rm --entrypoint ls api:1.0 -la /app. La proiecte TypeScript, asigură-te că pasul de build produce chiar fișierul din CMD (dist/main.js).
Întrebări frecvente
E aceeași eroare cu Cannot find module 'express'?
Nu. Cu o cale absolută ('/app/server.js') lipsește fișierul tău de pornire. Cu un nume de pachet ('express') lipsește un pachet din node_modules: n-ai rulat npm install în imagine sau un volum ascunde node_modules.
Local merge cu node server.js. De ce în container nu?
Local rulezi din folderul proiectului. În container, folderul curent e WORKDIR-ul imaginii, iar acolo există doar ce ai copiat cu COPY.
Erori înrudite
python: can't open file '/app/app.py': [Errno 2] No such file or directory Containerul pornește python app.py în WORKDIR (/app), dar fișierul nu e acolo în imagine: lipsește COPY, a fost copiat în alt folder sau un volum montat peste /app îl ascunde. Adaugă COPY app.py . după WORKDIR /app, reconstruiește imaginea și pornește containerul din nou. 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. ERROR: failed to solve: failed to compute cache key: failed to calculate checksum of ref ...: "/app.py": not found Fișierul din COPY nu există în contextul de build, adică în folderul dat lui docker build (de obicei punctul final). Verifică calea relativă la acel folder, nu la Dockerfile, și dacă fișierul nu e exclus în .dockerignore. Î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.
