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

解决FastGPT部署后系统初始化失败fetch报错问题

部署FastGPT私有部署版本后,启动fastgpt-app容器时出现以下日志:首先输出Postgres慢查询告警,涉及SQL为CREATE EXTENSION IF NOT EXISTS vector;以及创建modeldata表的语句,耗时320ms;随后出现[pluginerror]: fetch f…

现象

部署FastGPT私有部署版本后,启动fastgpt-app容器时出现以下日志:首先输出Postgres慢查询告警,涉及SQL为CREATE EXTENSION IF NOT EXISTS vector;以及创建modeldata表的语句,耗时320ms;随后出现[plugin_error]: fetch failed报错,系统初始化步骤instrumentation-check失败,最终系统初始化失败。

可能原因

  1. Postgres数据库执行初始化SQL时耗时过长,触发慢查询告警,可能阻塞后续初始化流程;
  2. 变更code-sandbox配置(移除bun模式)后,相关插件的网络请求出现异常;
  3. 部署环境的网络、依赖版本等配置与当前部署包存在不兼容情况,需按实际环境确认。

排查步骤

  1. 查看fastgpt-app容器的完整日志,确认[plugin_error]: fetch failed和慢查询SQL的具体内容;
  2. 检查Postgres数据库的连接状态,确认数据库服务正常运行,且当前账号拥有创建extension和表的权限;
  3. 核对code-sandbox的配置变更步骤,确认移除bun模式的操作是否正确执行;
  4. 检查部署环境的网络连通性,确认容器之间的网络请求无阻塞。

解决与验证

  1. 回退code-sandbox的配置变更,恢复原有的bun模式配置,验证是否能正常启动容器;
  2. 登录Postgres数据库,检查vector扩展和modeldata表是否成功创建;
  3. 重启fastgpt-app容器,观察日志是否仍出现[plugin_error]: fetch failed报错。

若重启后容器正常启动,无上述报错且可正常访问FastGPT服务,则问题解决。

来源:FastGPT GitHub issue