使用npm run dev启动Next.js应用时始终处于就绪状态无响应

试试下面这些排查步骤：

• 检查端口占用
  Next.js默认使用3000端口，若该端口被其他程序占用，服务可能无法正常启动。

  • Windows：执行netstat -ano | findstr :3000找到占用端口的进程ID，再用taskkill /F /PID <进程ID>杀掉进程
  • Mac/Linux：执行lsof -i :3000找到进程，用kill -9 <进程ID>结束进程
    或者直接指定其他端口启动：npm run dev -- -p 3001

• 清理依赖并重新安装
  依赖缓存或损坏可能导致启动异常：

# 删除依赖目录和锁文件
rm -rf node_modules package-lock.json
# 重新安装依赖
npm install

Windows环境替换为：

rmdir /s node_modules
del package-lock.json
npm install

• 核对Node.js与Next.js版本兼容性
  Next.js对Node.js版本有要求，版本不匹配可能引发启动问题。查看项目package.json里的Next.js版本，对照官方文档确认所需Node.js版本，可通过nvm（Node版本管理器）切换合适的Node.js版本。

• 临时禁用防火墙/杀毒软件
  部分防火墙或杀毒软件会拦截Next.js的服务请求，临时关闭后再尝试启动应用，排查是否是这类软件导致的阻塞。

• 排查项目配置文件
  若自定义了next.config.js，可能存在错误配置导致启动卡住。先备份该文件，然后删除它，再执行npm run dev，如果能正常启动，再逐步排查配置里的问题。

• 更换包管理器尝试
  切换到yarn或pnpm启动应用，排除npm本身的问题：

# 用yarn
yarn dev
# 用pnpm
pnpm dev

内容的提问来源于stack exchange，提问作者Girish Vazheliparambil Girijan