...
Eroare Docker · Dockerfile și docker build

npm error enoent Could not read package.json: Error: ENOENT: no such file or directory, open '/app/package.json'

Pe scurt

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.

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

Ce înseamnă

npm caută package.json în folderul curent, adică WORKDIR-ul din Dockerfile. ENOENT (Error NO ENTry) înseamnă că fișierul nu există la calea din mesaj (/app/package.json). Build-ul se oprește la pasul RUN npm install, de obicei cu exit code: 254.

Cauzele sunt aceleași ca la orice fișier care lipsește în imagine:

  • RUN npm install înainte de orice COPY;
  • package.json copiat în alt folder (COPY package.json /) decât WORKDIR;
  • proiectul are package.json într-un subfolder (api/package.json), iar contextul de build e folderul părinte;
  • package.json exclus din context în .dockerignore.

Calea din mesaj îți spune unde l-a căutat npm; compar-o cu WORKDIR și cu destinațiile COPY.

De ce apare: cauzele frecvente

1npm install înainte de COPY

Greșit
BASH
WORKDIR /app
RUN npm install
COPY . .
Corect
BASH
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .

package.json trebuie copiat în /app înainte ca npm să-l citească.

2Copiat în alt folder

Greșit
BASH
COPY package.json /
WORKDIR /app
RUN npm install
Corect
BASH
WORKDIR /app
COPY package.json ./
RUN npm install

npm caută în WORKDIR, nu în rădăcina imaginii.

3Proiect într-un subfolder

Greșit
BASH
docker build -t api .   # package.json e în ./api
Corect
BASH
docker build -t api ./api

Contextul de build trebuie să fie folderul care conține package.json.

Repară tu

Repară eroarea, direct în pagină

Build-ul API-ului Node din ~/api (docker build -t api:1.0 .) se oprește la RUN npm install cu npm error enoent Could not read package.json. Repară ordinea din Dockerfile, construiește api:1.0 și pornește containerul api pe portul 3000.

Indiciu

Înainte de RUN npm install, copiază package*.json în WORKDIR.

Alte forme ale mesajului

  • npm ERR! enoent ENOENT: no such file or directory, open '/app/package.json'
  • npm error code ENOENT npm error syscall open npm error path /app/package.json
  • npm ERR! code ENOENT

Cum o eviți pe viitor

Folosește tiparul standard pentru Node: WORKDIR /app, COPY package*.json ./, RUN npm ci (sau npm install), COPY . .. Rulează docker build din folderul care conține package.json și verifică .dockerignore, ca să excludă node_modules, nu și fișierele de configurare ale proiectului.

Întrebări frecvente

De ce package*.json și nu doar package.json?

Steluța prinde și package-lock.json. Cu lock file-ul în imagine, npm ci instalează exact versiunile testate, iar build-ul e reproductibil.

Ce e exit code 254?

E codul cu care npm iese când nu poate citi fișierele de care are nevoie, cum e aici package.json. Cauza e în liniile npm error de deasupra.

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.