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

FastGPT常见部署与使用异常问题排查与解决指南

Milvus数据库连接异常:大量数据导入后出现fastgpt 14 UNAVAILABLE: Name resolution failed for target dns:milvusStandalone:19530错误,怀疑Milvus因数据量过大崩溃。

现象

  1. Milvus数据库连接异常:大量数据导入后出现fastgpt 14 UNAVAILABLE: Name resolution failed for target dns:milvusStandalone:19530错误,怀疑Milvus因数据量过大崩溃。
  2. 知识库页面崩溃:点击“知识库”时页面崩溃,禁用相关if控件后问题消失。
  3. Invalid array length错误:创建知识库时使用m3e Embeddings和问答拆分处理方式时出现,修改PostgreSQL vector字段长度未解决。
  4. PDF增强解析接口速度慢:上传大页数PDF文件时,marker-pdf解析器耗时过长,前端网络请求超时并显示错误提示,但文件实际上传成功。
  5. 上传文档无法解析:私有部署v4.8.17版本中,上传文档后模型无法解析内容或生成总结,点击文档链接未正常展示内容。

可能原因

  1. Milvus数据库连接异常:可能因数据量过大导致Milvus服务崩溃,或域名解析配置存在异常。
  2. 知识库页面崩溃:与页面内if控件的条件判断逻辑相关,可能存在空值或非法值触发崩溃。
  3. Invalid array length错误:PostgreSQL vector字段长度与m3e Embeddings的向量维度不匹配,修改字段长度未生效或未匹配实际需求。
  4. PDF增强解析接口速度慢:marker-pdf解析器处理大页数PDF文件耗时过长,前端未适配长耗时请求的交互逻辑。
  5. 上传文档无法解析:私有部署版本的文档解析服务配置异常,或解析流程存在断点。

排查步骤

  1. 检查Milvus服务运行状态,查看服务日志确认是否因数据量过大崩溃,验证域名解析配置是否正确。
  2. 排查知识库页面的if控件逻辑,逐步禁用可疑控件定位崩溃触发点。
  3. 核对PostgreSQL vector字段长度与m3e Embeddings的向量维度参数,确认配置匹配。
  4. 测试小页数PDF文件上传,对比解析耗时,确认大文件解析超时问题。
  5. 检查私有部署版本的文档解析服务配置,查看解析服务日志定位断点。

解决与验证

针对各异常问题的解决方式需结合实际场景:

  1. Milvus数据库连接异常:修复域名解析配置,重启Milvus服务恢复运行,根据数据量调整服务资源配置。验证:重启后服务正常运行,无连接报错。
  2. 知识库页面崩溃:修复if控件的条件判断逻辑,避免空指针或非法值触发崩溃。验证:点击“知识库”页面正常加载,无崩溃现象。
  3. Invalid array length错误:重新配置PostgreSQL vector字段长度,匹配m3e Embeddings的向量维度,需确认嵌入模型输出的向量实际维度。验证:创建知识库时无报错,功能正常运行。
  4. PDF增强解析接口速度慢:优化marker-pdf解析器的并发处理逻辑,前端增加长请求加载提示,避免超时提示干扰。验证:大页数PDF上传后解析耗时符合预期,前端无错误提示。
  5. 上传文档无法解析:重启文档解析服务,检查解析服务的依赖配置,升级至最新版本修复已知解析问题。验证:文档可正常解析,点击链接可正常展示内容。

来源: FastGPT GitHub issue #4461