...
Eroare Docker · Containere care se opresc imediat

Error: Cannot find module '/app/server.js'

Pe scurt

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

Greșit
BASH
WORKDIR /app
COPY server.js /usr/src/app/
CMD ["node", "server.js"]
Corect
BASH
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

Greșit
BASH
COPY . .
CMD ["node", "server.js"]
# codul e în src/server.js
Corect
BASH
COPY . .
CMD ["node", "src/server.js"]

Calea din CMD trebuie să corespundă structurii proiectului copiat.

3Volum montat peste /app

Greșit
BASH
docker run -v $(pwd)/public:/app api:1.0
Corect
BASH
docker run -v $(pwd):/app -v /app/node_modules api:1.0

Montezi tot proiectul (cu server.js), iar volumul anonim păstrează node_modules din imagine.

Repară tu

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/).

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

← Toate erorile Docker

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