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

解决FastGPT私有部署版PDF/Word知识库上传后无数据问题

使用Docker部署V4.8.21私有部署版本的FastGPT,上传TXT和MarkDown格式文件时,可正常完成上传与拆分流程。但PDF和Word文档上传时,进度显示100%,进入数据处理步骤后,来源列表中的文件消失。点击下一步后仅弹出成功提示,但知识库新增文件数量为0。

现象

使用Docker部署V4.8.21私有部署版本的FastGPT,上传TXT和MarkDown格式文件时,可正常完成上传与拆分流程。但PDF和Word文档上传时,进度显示100%,进入数据处理步骤后,来源列表中的文件消失。点击下一步后仅弹出成功提示,但知识库新增文件数量为0。

可能原因

该问题的具体触发原因未在反馈中明确,需结合部署环境的运行日志与配置项进行排查。已知该问题仅出现在Docker部署的V4.8.21版本,且仅影响PDF、Word格式文件的知识库上传处理流程。

排查步骤

  1. 确认当前FastGPT的部署版本为Docker部署V4.8.21,核对版本号是否与反馈一致。
  2. 仅针对PDF和Word格式文件出现异常时,优先聚焦该类文件的处理流程开展排查。
  3. 查看FastGPT服务的运行日志,搜索与文件解析、数据处理相关的日志条目。
  4. 确认已配置的密钥可正常使用,无相关权限限制。
  5. 对比TXT、MarkDown格式文件的上传流程,确认两类文件的处理差异点。

解决与验证

目前未在该反馈中提供明确的解决方法。可根据排查步骤获取的日志信息,定位具体异常节点后进行针对性处理。验证方式为:重新上传PDF或Word格式文件,确认上传进度完成后,来源列表可正常显示文件,且知识库新增文件数量不为0。

来源:FastGPT GitHub issue