现象
出现两类异常情况:一是填写部分必填变量后,仍可通过快捷按键链接启动对话;二是未选择区服时,TKP作为提示词内容展示。此外,升级至v4.3版本后,应用及知识库数据丢失,切换回latest镜像后数据恢复。
可能原因
异常情况的潜在原因包括:v4.3版本必填项校验逻辑未正确生效;升级v4.3时未关联原有数据库实例,导致数据被重置;环境变量配置未完全生效,未完成版本初始化。
排查步骤
- 确认当前FastGPT版本,可通过镜像标签或页面信息核对;
- 检查Docker Compose配置文件中是否已添加FILETOKENKEY环境变量;
- 核对是否执行了v4.3版本初始化命令:curl http://mydomain/api/admin/initv43 -H "rootkey: root_key";
- 检查容器是否关联了原有PostgreSQL和MongoDB数据库实例,避免使用全新数据库;
- 测试未填写全部必填变量时,点击快捷按键的交互反馈。
解决与验证
- 编辑Docker Compose配置文件,添加FILETOKENKEY环境变量;
- 执行v4.3版本初始化命令,替换rootkey为实际的rootkey:curl http://mydomain/api/admin/initv43 -H "rootkey: rootkey";
- 启动容器时指定registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt:v4.3镜像,并关联原有数据库实例;
- 验证:未填写全部必填变量时,点击快捷按键应无法启动对话;升级后应用及知识库数据可正常恢复。