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

解决FastGPT 4.7版本高级编排模块模型下拉框为空问题

从4.6.9版本升级至FastGPT 4.7私有部署版本后,高级编排功能中的问题分类模块、文本内容提取模块无法选择AI模型,对应的下拉框为空。用户提供的截图显示,这两个模块的模型选择下拉框无任何可选模型列表,而AI对话模块可正常加载并显示可用的AI模型,无异常表现。

现象

从4.6.9版本升级至FastGPT 4.7私有部署版本后,高级编排功能中的问题分类模块、文本内容提取模块无法选择AI模型,对应的下拉框为空。用户提供的截图显示,这两个模块的模型选择下拉框无任何可选模型列表,而AI对话模块可正常加载并显示可用的AI模型,无异常表现。该问题仅在升级后的私有部署场景中出现,升级前的4.6.9版本无此问题。

可能原因

该问题仅在从4.6.9版本升级至4.7版本的私有部署场景中出现,暂未公开具体的触发逻辑。由于AI对话模块功能正常,可排除全局模型配置、API Key有效性等基础问题,推测异常可能与高级编排模块的模型加载逻辑在版本升级后出现变更或兼容问题有关,具体原因需结合实际部署环境进一步确认。

排查步骤

  1. 确认当前FastGPT私有部署的版本为4.7,且升级前的版本为4.6.9,明确问题的触发场景为版本升级后。
  2. 测试AI对话模块的模型选择功能,确认该功能可正常加载并选择目标模型,以此排除全局模型配置异常、API Key无效等基础问题。该问题中用户已确认自身API Key可正常使用,且对话模块功能正常。
  3. 进入高级编排页面,分别打开问题分类模块、文本内容提取模块的配置界面,查看模型下拉框是否为空,确认异常表现的范围。
  4. 核对FastGPT版本升级过程中的配置变更记录,排查是否存在配置文件遗漏、环境变量修改错误等问题。
  5. 查看FastGPT的后台日志,搜索与模型加载、高级编排模块相关的报错信息,辅助定位问题。

解决与验证

  1. 若仅高级编排的问题分类、文本内容提取模块出现模型下拉框为空的问题,可记录当前的部署环境信息、版本升级路径等内容,反馈至官方issue跟进。
  2. 等待官方发布对应版本的修复补丁后,按照官方的升级流程重新部署更新FastGPT,即可恢复高级编排模块的模型选择功能。
  3. 完成更新后,进入高级编排页面,分别测试问题分类模块、文本内容提取模块的模型下拉框,确认是否可正常显示并选择目标AI模型,验证问题是否解决。

来源:FastGPT GitHub issue