首次使用Next.js：执行npm run dev后服务器几秒内自动终止

1. 检查端口占用 #

3000端口可能被其他程序占用，导致Next.js无法持续监听：

• Windows执行命令查看占用：netstat -ano | findstr :3000
• macOS/Linux执行命令查看占用：lsof -i :3000
• 找到对应进程PID后，Windows用taskkill /PID 进程号 /F、macOS/Linux用kill -9 进程号杀掉进程，再重启npm run dev

2. 清理依赖缓存 #

依赖包损坏或冲突可能导致异常：

• 删除依赖文件夹和锁文件：

  # macOS/Linux
  rm -rf node_modules package-lock.json yarn.lock
  # Windows命令行
  rmdir /s /q node_modules && del package-lock.json yarn.lock
  

• 重新安装依赖：npm install 或 yarn install
• 再次启动开发服务器

3. 查看终端错误日志 #

服务器终止时，终端会输出关键错误信息，重点排查：

• 模块缺失、语法错误提示
• 环境变量配置问题
• 文件读写权限不足的报错

4. 更换端口启动 #

直接指定其他端口避开冲突：

npm run dev -- -p 3001
# 或
yarn dev -p 3001

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

Next.js要求Node.js版本不低于v16.8（建议LTS稳定版）：

• 查看当前版本：node -v
• 版本过低则升级后重新测试

内容的提问来源于stack exchange，提问作者Oyeleke Isreal Timilehin