Next.js の dev server が起動できない
Next.js の next dev が起動できないときは、ポート競合・Node.js バージョン・.next キャッシュ破損の 3 点を順に切り分ける。
占有プロセス確認・対応 Node 確認・キャッシュ削除で大半は復旧する。
公開: 更新:
npx -y node@18 node_modules/next/dist/bin/next dev -p 3005 You are using Node.js 18.20.8. For Next.js, Node.js version ">=20.9.0" is required.
2026-11-07 に node:20(Next.js 16.4.5 / Node.js 20.20.2) で実際に打って取った出力。検証環境の詳細
要約
next dev が起動できないときは ポート競合 → Node バージョン → .next キャッシュ の順で切り分ける。
多くの場合、占有プロセスを止めるか .next を消すだけで復旧する。next.config.js を最小構成に戻して問題を二分するのも有効である。
実行例
ポート 3000 が使用中の状態で next dev -p 3000 を実行すると Failed to start server と EADDRINUSE で失敗した。-p 3001 に変えると Next.js 16.4.5 が起動し、curl が 200 を返した。
Node.js 18 で起動すると >=20.9.0 が必要だと案内され、終了コード 1 で止まった。
$ npx next dev -p 3000 2>&1 | head -n 3
⨯ Failed to start server
Error: listen EADDRINUSE: address already in use :::3000
at new Promise (<anonymous>) {$ npx next dev -p 3001 > dev.log 2>&1 &$ cat dev.log
▲ Next.js 16.4.5 (Turbopack)
- Local: http://localhost:3001
- Network: http://172.17.0.2:3001
✓ Ready in 225ms
✓ Running next.config took 10ms
GET / 200 in 224ms (next.js: 116ms, application-code: 108ms)$ curl -s -o /dev/null -w '%{http_code}\n' http://localhost:3001
200$ npx -y node@18 node_modules/next/dist/bin/next dev -p 3005
You are using Node.js 18.20.8. For Next.js, Node.js version ">=20.9.0" is required.
$ echo $?
1$ node -v
v20.20.2— 2026-11-07 時点の出力
検証環境Node.js 20.20.2 / npm 10.8.2 / Python 3.11.2 / 2026-11-07 検証(ほか 2 件)
- 検証日
- 実行環境
node:20Debian GNU/Linux 12 (bookworm)- バージョン
- Node.js 20.20.2
- npm 10.8.2
- Python 3.11.2
- Git 2.39.5
- Next.js 16.4.5
この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。
解決策
1. ポート競合を確認する
lsof -i :3000 # macOS / Linux
netstat -ano | findstr :3000 # Windows該当プロセスを終了するか、別ポートで起動する。
npx next dev -p 30012. Node.js バージョンを確認する
node -vNext.js の CLI ドキュメント(新しいタブで開く) で必要バージョンを確認し、nvm や volta で切替える。
nvm use 203. キャッシュと依存を作り直す
rm -rf .next node_modules package-lock.json
npm install
npm run dev.next 削除だけで直ることも多い。
まず .next を試し、ダメなら node_modules まで広げる。
4. next.config.js を切り分ける
最小構成にして起動を試す。
/** @type {import('next').NextConfig} */
const nextConfig = {};
module.exports = nextConfig;起動できれば、削った設定を 1 つずつ戻して原因オプションを特定する。
各オプションのサポート状況は公式の設定リファレンス(新しいタブで開く)で確認する。
よくある原因
- ポート 3000 が既に使われている。
別ターミナルのnext devが残っているか、Vite / Docker / 別アプリが占有している。
ただし-pもPORTも付けないnext devは、⚠ Port 3000 is in use by an unknown process, using available port 3001 instead.と出して空いているポートで起動する(Next.js 16.3.8 で確認)。listen EADDRINUSEで起動に失敗するのは、next dev -p 3000やPORT=3000でポートを明示したときである。 - Node.js のバージョンが対応外である。
Next.js は公式ドキュメント(新しいタブで開く)で対応 Node を明記しており、範囲外だと起動に失敗する。 .nextキャッシュが壊れている。
ブランチ切替直後や依存更新後に、ビルドキャッシュが矛盾する。- 依存が壊れている。
node_modulesが不整合を起こしているか、lockfile とpackage.jsonが一致していない。 next.config.jsに問題がある。
文法エラーや、削除された旧オプション(swcMinifyなど)が残っている。