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

解决FastGPT v4.3版本必填项校验失效与升级数据异常问题

出现两类异常情况:一是填写部分必填变量后,仍可通过快捷按键链接启动对话;二是未选择区服时,TKP作为提示词内容展示。此外,升级至v4.3版本后,应用及知识库数据丢失,切换回latest镜像后数据恢复。

现象

出现两类异常情况:一是填写部分必填变量后,仍可通过快捷按键链接启动对话;二是未选择区服时,TKP作为提示词内容展示。此外,升级至v4.3版本后,应用及知识库数据丢失,切换回latest镜像后数据恢复。

可能原因

异常情况的潜在原因包括:v4.3版本必填项校验逻辑未正确生效;升级v4.3时未关联原有数据库实例,导致数据被重置;环境变量配置未完全生效,未完成版本初始化。

排查步骤

  1. 确认当前FastGPT版本,可通过镜像标签或页面信息核对;
  2. 检查Docker Compose配置文件中是否已添加FILETOKENKEY环境变量;
  3. 核对是否执行了v4.3版本初始化命令:curl http://mydomain/api/admin/initv43 -H "rootkey: root_key";
  4. 检查容器是否关联了原有PostgreSQL和MongoDB数据库实例,避免使用全新数据库;
  5. 测试未填写全部必填变量时,点击快捷按键的交互反馈。

解决与验证

  1. 编辑Docker Compose配置文件,添加FILETOKENKEY环境变量;
  2. 执行v4.3版本初始化命令,替换rootkey为实际的rootkey:curl http://mydomain/api/admin/initv43 -H "rootkey: rootkey";
  3. 启动容器时指定registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt:v4.3镜像,并关联原有数据库实例;
  4. 验证:未填写全部必填变量时,点击快捷按键应无法启动对话;升级后应用及知识库数据可正常恢复。

来源: FastGPT GitHub issue #211