故障排查GitHub issue2 分钟阅读排错/错误码

FastGPT从v4.8.8升级至v4.8.9初始化请求报错的排查与解决

私有部署FastGPT v4.8.8版本时,将fastgpt和fastgpt-sandbox镜像替换为v4.8.9后,执行初始化curl命令: 返回了包含Next.js前端页面结构的HTML内容,页面包含AIapp:intro描述、404相关脚本与静态资源加载信息。

现象

私有部署FastGPT v4.8.8版本时,将fastgpt和fastgpt-sandbox镜像替换为v4.8.9后,执行初始化curl命令:

curl --location --request POST 'http://内网ip:3003/api/admin/init/489' \
--header 'rootkey: /Q=' \
--header 'Content-Type: application/json'

返回了包含Next.js前端页面结构的HTML内容,页面包含AIapp:intro描述、404相关脚本与静态资源加载信息。

可能原因

已知潜在原因包括:请求未匹配到后端API接口,返回了前端静态页面;服务容器启动异常;内网访问配置或端口映射存在问题。

排查步骤

  1. 执行docker ps命令,检查fastgpt和fastgpt-sandbox容器的运行状态,确认容器无异常退出。
  2. 直接访问http://内网ip:3003,确认是否能正常加载FastGPT前端页面,验证网络连通性与端口3003的可用性。
  3. 执行docker logs 容器名查看对应FastGPT容器的启动日志,排查后端服务启动时的报错信息。
  4. 核对初始化请求的路径、请求头参数,确保与提供的curl命令完全一致,避免拼写错误。

解决与验证

若容器未正常启动,重新拉取对应版本的镜像并正确启动容器;若接口请求被前端路由拦截,需确认后端服务优先启动,或检查反向代理配置是否正确转发API请求至后端服务;若网络配置存在问题,修正内网IP与端口映射设置。 验证方式:重新执行初始化curl命令,若返回标准JSON格式的成功响应,则问题解决。

来源:FastGPT GitHub issue