Next.js项目中yarn dev启动本地服务无限加载问题求助

以下是几个实用的排查和解决步骤，按顺序尝试：

1. 清理缓存与依赖 #

缓存残留或依赖损坏可能导致启动异常：

• 删除Next.js编译缓存目录：rm -rf .next（Windows系统执行rmdir /s .next）
• 清空Yarn本地缓存：yarn cache clean
• 删除node_modules重新安装依赖：rm -rf node_modules && yarn install
• 再次启动服务：yarn dev

2. 检查并释放端口 #

上次服务退出时可能未正常释放默认端口（3000）：

• macOS/Linux：执行lsof -i :3000找到占用端口的进程PID，然后用kill -9 [PID]强制终止
• Windows：执行netstat -ano | findstr :3000获取PID，再运行taskkill /F /PID [PID]结束进程
  完成后重新启动yarn dev

3. 排除VS Code插件干扰 #

部分VS Code插件可能在后台占用资源或干扰服务启动：

• 完全关闭VS Code，直接用系统自带终端运行yarn dev
• 如果服务能正常启动，再逐个启用VS Code插件，定位出问题插件并禁用

4. 验证Node.js版本兼容性 #

Next.js对Node.js版本有要求，确保使用官方推荐的LTS版本：

• 用node -v查看当前版本，对比Next.js官方文档要求（一般推荐18.x或20.x LTS）
• 若版本不符，使用nvm或n等版本管理工具切换到符合要求的LTS版本，再重新执行yarn dev

5. 重置项目配置 #

如果以上步骤无效，尝试恢复默认配置排查：

• 备份next.config.js内容后删除该文件，用默认配置启动yarn dev
• 若服务正常，再逐步将备份的配置代码加回去，定位导致卡顿的配置项

内容的提问来源于stack exchange，提问作者Marko Mitic