Start script missing error when running npm start の原因と直し方【Dockerで検証済み】
Start script missing error when running npm start の原因と解決方法。検証済みの解決コマンド付きで、現象→原因→解決→確認の順に最短で直せます。
発生したエラー
Start script missing error when running npm start結論：まずこれで直ります
このエラーは package.json に 'scripts' フィールドがないか、あっても 'start' キーが定義されていない場合に発生します。下の解決コマンドを順に実行すれば直ります。
cd /app && node -e "const fs=require('fs');const pkg=JSON.parse(fs.readFileSync('package.json'));pkg.scripts=pkg.scripts||{};pkg.scripts.start='node index.js';fs.writeFileSync('package.json',JSON.stringify(pkg,null,2));" && echo 'console.log("Server started successfully");' > index.js現象どんなエラーか
次の操作を行うと（検証環境: node:20）、上記のエラーが発生します。まずは下の再現コマンドで、同じ状況を再現できることを確認してください。
検証環境：node:20
mkdir -p /app && cd /app && echo '{"name":"myapp","version":"1.0.0"}' > package.json && npm start原因なぜ起きるのか
このエラーは package.json に 'scripts' フィールドがないか、あっても 'start' キーが定義されていない場合に発生します。npm start を実行すると npm は package.json 内の scripts.start を探し、見つからない場合に 'Missing script: start' エラーを返します。修正方法は package.json の scripts セクションに start エントリを追加することです。一般的には 'node index.js' や 'node server.js' のようにエントリポイントとなるファイルを指定します。今回は scripts.start に 'node index.js' を追加し、動作確認用の最小限の index.js も作成することで問題を解消しています。
解決解決手順
cd /app && node -e "const fs=require('fs');const pkg=JSON.parse(fs.readFileSync('package.json'));pkg.scripts=pkg.scripts||{};pkg.scripts.start='node index.js';fs.writeFileSync('package.json',JSON.stringify(pkg,null,2));" && echo 'console.log("Server started successfully");' > index.js確認直ったか確認する
cd /app && npm start 2>&1 | grep -q 'Server started successfully' && exit 0 || exit 1動画で見る
この記事の解決手順は実環境で検証しています
山田 英紀（社内SE 5年以上・13業種以上の業務システムを開発／運用）が、 掲載コマンドを検証環境で実行し、再現〜解決〜確認まで通ることを確認しています。