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

解决FastGPT升级后知识库搜索无法匹配内容的问题

FastGPT私有部署版本4.8.3升级后,执行初始化脚本与脏数据清理操作,知识库搜索测试无法匹配任何内容。仅手动逐条更新单条数据集内容后,才可恢复正常搜索匹配功能。 部署过程中使用了与当前向量数据库不匹配的docker-compose配置文件。

现象

FastGPT私有部署版本4.8.3升级后,执行初始化脚本与脏数据清理操作,知识库搜索测试无法匹配任何内容。仅手动逐条更新单条数据集内容后,才可恢复正常搜索匹配功能。

可能原因

部署过程中使用了与当前向量数据库不匹配的docker-compose配置文件。例如原本使用pgvector向量数据库,却误用了milvus对应的配置文件,导致向量索引无法正常生成或关联。

排查步骤

  1. 确认当前FastGPT部署所使用的docker-compose配置文件名称。
  2. 核对配置文件与所使用的向量数据库类型是否匹配,pgvector对应docker-compose-pgvector.yml,milvus对应docker-compose-milvus.yml。
  3. 检查向量数据库的运行状态与连接日志,确认是否存在连接异常或索引生成失败的情况。

解决与验证

  1. 若原本使用pgvector向量数据库,将docker-compose配置文件更换为docker-compose-pgvector.yml。
  2. 若使用milvus向量数据库,可正常使用docker-compose-milvus.yml部署。
  3. 更换配置文件后,重新启动FastGPT服务,执行知识库搜索测试,验证是否可正常匹配内容。
  4. 若需快速解决问题,可尝试切换索引模型,该方式操作较为简便。

来源: FastGPT GitHub issue #1656