Next.js项目执行npm run dev后本地服务器自动停止求助

排查步骤与解决方案 #

1. 检查端口占用情况 #

开发服务器默认使用3000端口，先确认该端口是否被其他程序占用：

• Windows：打开命令提示符，执行 netstat -ano | findstr :3000，找到对应PID后在任务管理器结束进程
• macOS/Linux：执行 lsof -i :3000，用 kill -9 <PID> 终止占用端口的进程
  之后重新运行 npm run dev，也可以指定其他端口测试：npm run dev -- -p 3001

2. 清理缓存与依赖 #

• 删除项目根目录下的 .next 和 node_modules 文件夹
• 清除npm缓存：npm cache clean --force
• 重新安装依赖：npm install
• 再次启动服务器：npm run dev

3. 验证package.json配置 #

确认scripts区域的dev命令是否正确，正常配置应为：

"scripts": {
  "dev": "next dev",
  "build": "next build",
  "start": "next start",
  "lint": "next lint"
}

如果有自定义参数，暂时移除后再测试启动。

4. 检查Node.js版本兼容性 #

Next.js对Node.js版本有要求，建议使用官方推荐的LTS版本（如18.x或20.x）。执行 node -v 查看当前版本，若版本过低，升级后重新尝试启动。

5. 排查配置文件异常 #

若项目中有损坏的配置文件（比如next.config.js），可能导致服务器崩溃。暂时将next.config.js重命名为next.config.backup.js，再启动服务器测试是否正常。

内容的提问来源于stack exchange，提问作者Just A Guy