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

FastGPT 4.0升级后令牌无效与向量生成错误排错指南

升级到4.0版本后,出现无效令牌提示,无法查看此前创建的应用,可正常创建应用,对话环节提示无效令牌,可查看此前创建的知识库。部分场景下出现生成向量错误,报错文本为unAuthorization,可正常对话但导入数据库失败。部分用户选择特定模型时出现调用异常。

现象

升级到4.0版本后,出现无效令牌提示,无法查看此前创建的应用,可正常创建应用,对话环节提示无效令牌,可查看此前创建的知识库。部分场景下出现生成向量错误,报错文本为unAuthorization,可正常对话但导入数据库失败。部分用户选择特定模型时出现调用异常。

可能原因

一是OneAPI项目相关问题;二是MySQL每小时同步操作导致的短时服务异常;三是环境变量配置发生变动,原有密钥相关参数不再适配新版本。

排查步骤

  1. 核对当前环境变量配置,确认密钥相关参数是否符合最新版本规范
  2. 检查MySQL服务运行状态,确认是否存在周期性同步导致的异常
  3. 测试不同模型的调用与向量生成流程,定位异常触发条件
  4. 排查鉴权相关配置,确认令牌与密钥的有效性

解决与验证

  1. 调整环境变量配置,将OPENAIKEY替换为CHAT_API_KEY,不再单独部署OPENAI_TRAINING_KEYGPT4KEY,通过openapi集中管理密钥与访问URL
  2. 若异常由MySQL同步导致,等待异常时段结束或调整同步周期(需按实际环境确认)
  3. 验证令牌有效性、应用查看功能、向量生成功能是否恢复正常

来源: FastGPT GitHub issue #164