如何排查Next.js应用执行npm run dev后进程立即终止的问题？

开发者阿泽

2026-7-20

Next.js npm run dev 启动后进程自动终止的解决办法

以下是针对该问题的排查和解决步骤：

检查端口占用情况
在Windows PowerShell中执行命令查看3000端口的占用状态：
```
netstat -ano | findstr :3000
```
如果返回结果显示端口被其他进程占用，执行命令强制终止对应进程（将<进程ID>替换为实际查到的PID）：
```
taskkill /F /PID <进程ID>
```
或者直接更换端口启动项目：
```
next dev -p 3001
```
清理依赖并重新安装
1. 删除项目根目录下的node_modules文件夹：
```
Remove-Item -Recurse -Force node_modules
```
2. 删除package-lock.json文件：
```
Remove-Item package-lock.json
```
3. 重新安装项目依赖：
```
npm install
```
验证版本兼容性
- 查看当前项目的Next.js版本：
```
npm list next
```
- 确认Node.js版本符合Next.js官方要求（推荐使用18.x或20.x LTS版本）：
```
node -v
```
- 若版本不匹配，可通过nvm管理工具切换Node.js版本，或升级Next.js到最新稳定版：
```
npm install next@latest
```
排查项目代码错误
- 检查项目入口文件（如pages/_app.js、pages/index.js或app目录下的组件）是否存在语法错误、未捕获的异常
- 创建全新Next.js项目测试，确认是否为当前项目代码导致的问题：
```
npx create-next-app@latest test-app
cd test-app
npm run dev
```