npm error Missing script: "start"
CMD ["npm", "start"] rulează scriptul start din package.json, dar acolo nu există. Adaugă-l în scripts ("start": "node server.js") și reconstruiește imaginea, sau pornește direct aplicația: CMD ["node", "server.js"].
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
npm start nu pornește magic aplicația: caută în package.json cheia scripts.start și rulează comanda de acolo. Dacă nu o găsește, npm afișează Missing script: "start", sugerează npm run ca să vezi scripturile existente și iese cu cod 1. Containerul se oprește imediat, iar mesajul apare în docker logs.
Cauze frecvente: proiectul are doar dev (de exemplu pentru nodemon) sau serve; scriptul e scris în alt loc din package.json (în afara lui scripts); în imagine a ajuns alt package.json (din alt folder, sau unul vechi, din cache); ori WORKDIR diferă de folderul cu package.json, iar npm citește alt fișier.
Cu docker run --rm imagine cat package.json vezi exact fișierul din imagine.
De ce apare: cauzele frecvente
1Scriptul start lipsește
"scripts": { "dev": "nodemon server.js" }"scripts": { "start": "node server.js", "dev": "nodemon server.js" }npm start rulează doar scripts.start.
2Alt nume de script în CMD
CMD ["npm", "start"] # package.json are doar "serve"CMD ["npm", "run", "serve"]Scripturile în afară de start, test și câteva standard se rulează cu npm run nume.
3Pornire directă, fără npm
CMD ["npm", "start"]CMD ["node", "server.js"]Fără npm la mijloc, procesul principal e node, care primește direct semnalele de oprire.
Repară eroarea, direct în pagină
API-ul din ~/api are în package.json doar scriptul dev, iar Dockerfile-ul pornește cu CMD ["npm", "start"]. Containerul api se oprește imediat cu npm error Missing script: "start". Adaugă scriptul start (node server.js), reconstruiește api:1.0 și pornește din nou api pe portul 3000.
Indiciu
În scripts din package.json, adaugă "start": "node server.js".
Reparația
În package.json:
"scripts": { "start": "node server.js", "dev": "node --watch server.js" }docker build -t api:1.0 .
docker rm -f api
docker run -d --name api -p 3000:3000 api:1.0
curl -s localhost:3000Salut din APIDe ce merge
npm start caută scripts.start în package.json, iar fișierul avea doar dev, deci npm ieșea cu cod 1 și containerul se oprea. Cu scriptul start adăugat și imaginea reconstruită, npm start rulează node server.js, serverul ascultă pe portul 3000, iar curl localhost:3000 primește răspunsul.
Alte forme ale mesajului
npm ERR! Missing script: "start"npm error Missing script: "dev"npm ERR! missing script: start
Cum o eviți pe viitor
Pune în package.json un script start care pornește aplicația în producție și testează imaginea local cu docker run --rm imagine înainte să o publici. Verifică scripturile din imagine cu docker run --rm imagine npm run. Mulți preferă CMD ["node", "server.js"], fără npm, ca semnalele de oprire să ajungă direct la aplicație.
Întrebări frecvente
Dacă nu există scripts.start, npm nu încearcă node server.js?
Da, dar doar când există un fișier server.js în folder și lipsește complet scripts.start. Dacă fișierul tău se numește altfel (index.js, src/app.js), primești această eroare.
Am adăugat scriptul, dar eroarea rămâne. De ce?
Containerul pornește din imaginea veche. Reconstruiește imaginea (docker build), șterge containerul vechi și pornește-l din nou din imaginea nouă.
Erori înrudite
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. npm error code EJSONPARSE package.json copiat în imagine nu e JSON valid: o virgulă în plus după ultimul element, ghilimele simple, un comentariu sau o acoladă lipsă. Linia JSON.parse din mesaj arată poziția. Repară fișierul (verifică-l cu node -e "require('./package.json')" sau cu un validator) și reconstruiește. 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: 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. Î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.
