现象
执行pnpm dev命令启动FastGPT后，访问localhost:3000，页面持续处于加载状态且无响应。telnet可正常连接对应端口，浏览器开发者工具控制台无报错信息，加载请求始终处于pending状态。该问题在M1、M2系列Mac设备上均有出现，使用Docker方式启动FastGPT也存在相同异常。
可能原因
该问题已知与环境版本不匹配相关，常见触发因素包括Node.js版本过低、项目依赖版本不符合要求，部分M1/M2系列Mac设备可能因环境适配问题出现异常。
排查步骤
- 打开浏览器F12开发者工具，查看控制台是否存在报错信息。
- 执行
node --version、pnpm -v、docker version命令，记录当前Node.js、pnpm、Docker的版本信息。 - 确认当前使用的设备是否为M1或M2系列Mac。
解决与验证
- 升级Node.js版本至v19.6.0及以上，升级pnpm版本至8.3.1及以上。
- 升级FastGPT项目的所有依赖包至适配版本。
- 重新执行
pnpm dev命令启动项目，访问localhost:3000，验证页面是否可正常加载并显示内容。 - 若使用Docker启动，可同步升级Docker环境版本后重新尝试。