故障排查GitHub issue2 分钟阅读故障排查

解决FastGPT通用知识库上传文件后持续处于索引状态的问题

私有部署版本V4.8.23的FastGPT中,创建通用知识库并上传文件后,文件持续处于索引状态。更换BAAI/bge-m3、BAAI/bge-large-zh-v1.5两个索引模型(均通过硅基流动配置),问题未解决。同一模型与硅基流动密钥在另一私有化环境可正常完成索引。

现象

私有部署版本V4.8.23的FastGPT中,创建通用知识库并上传文件后,文件持续处于索引状态。更换BAAI/bge-m3、BAAI/bge-large-zh-v1.5两个索引模型(均通过硅基流动配置),问题未解决。同一模型与硅基流动密钥在另一私有化环境可正常完成索引。用户提供了fastgpt与pg的日志截图。

可能原因

结合已知信息,可能的原因包括当前环境下索引模型调用异常、数据库连接异常、部署环境与可正常运行的环境存在配置差异。

排查步骤

  1. 确认当前使用的索引模型名称与硅基流动平台上的模型名称一致。
  2. 核对当前环境的硅基流动密钥配置,确保与可正常运行的私有化环境使用的密钥完全相同。
  3. 查看提供的fastgpt日志与pg日志截图,提取异常信息。
  4. 对比当前环境与可正常运行的私有化环境的部署配置差异。

解决与验证

根据排查结果修正对应异常项。验证方式为上传新文件,等待索引流程完成,确认文件状态不再显示为索引中。

来源: FastGPT 官方来源

适用性与版本范围

本页适用于官方来源记录的 故障排查 场景。执行变更前,需核对 FastGPT、依赖、API 与部署版本。

安全护栏

凭证与私密数据使用 [REDACTED_CREDENTIAL] 占位符。执行操作前需核对文档的环境与版本。

回滚指引

恢复变更前的技术内容权威快照、已保存配置与数据快照,再执行最小验证场景。