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

解决FastGPT部署场景下知识库搜索触发500报错的问题

两台离线部署的V4.8.13版本FastGPT,均能正常添加知识库并选择m3e向量模型;其中一台可完成知识库搜索任务,另一台搜索时触发500报错,请求ID为20241119XXXXXXXX,同时存在FastGPT服务日志与关联接口服务日志。

现象

两台离线部署的V4.8.13版本FastGPT,均能正常添加知识库并选择m3e向量模型;其中一台可完成知识库搜索任务,另一台搜索时触发500报错,请求ID为20241119XXXXXXXX,同时存在FastGPT服务日志与关联接口服务日志。

可能原因

结合报错类型与部署场景,可能的触发因素包括向量模型接口调用异常、两台机器的实际运行环境存在未被察觉的差异、知识库向量数据处理异常,或请求参数配置不一致。

排查步骤

  1. 确认两台机器的FastGPT版本均为V4.8.13,且非向量模型运行正常;
  2. 查看FastGPT服务日志,提取500报错对应的详细错误信息,核对请求ID20241119XXXXXXXX;
  3. 检查向量模型接口的连通性,确认调用链路是否正常;
  4. 对比两台机器的配置文件,核对向量模型相关的参数设置;
  5. 重新生成异常机器上的知识库向量数据,验证搜索功能。

解决与验证

根据排查步骤定位到具体异常原因后,执行对应修复操作。例如,若为接口连通问题则修复网络配置,若为参数不一致则统一配置参数,若为向量数据异常则重新生成向量数据。修复完成后,在异常机器上重新添加知识库,选择m3e模型并执行搜索任务,确认不再触发500报错,搜索结果可正常返回。

来源:FastGPT GitHub issue