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

解决FastGPT私有部署版知识库子目录PDF无法加载的问题

用户在FastGPT v4.8.11私有部署版本中,创建通用知识库并新建两层子目录,将PDF文件上传至第三层目录后,查看文件原始内容时提示"未能加载PDF文档"。在对话场景中关联该子目录下的PDF文件时,无法正常访问;但根目录下的同名PDF文件可正常访问。

现象

用户在FastGPT v4.8.11私有部署版本中,创建通用知识库并新建两层子目录,将PDF文件上传至第三层目录后,查看文件原始内容时提示"未能加载PDF文档"。在对话场景中关联该子目录下的PDF文件时,无法正常访问;但根目录下的同名PDF文件可正常访问。

可能原因

该问题的官方根因未明确披露,仅已知触发场景为知识库多层子目录下的PDF文件,具体根因需结合实际部署环境与服务日志确认。

排查步骤

  1. 确认当前使用的FastGPT版本为v4.8.11私有部署版本,且已验证自身密钥可正常使用。
  2. 分别测试根目录与多层子目录下的PDF文件访问情况,记录根目录文件可正常访问、子目录文件无法加载的现象。
  3. 查看FastGPT服务日志,检索与PDF文件加载、文件路径解析相关的报错信息。
  4. 核对服务器上对应知识库文件的存储路径与权限配置。

解决与验证

暂无公开的官方修复方案,可先将需访问的PDF文件转移至知识库根目录,临时恢复正常访问。如需彻底解决该问题,可提交该issue的完整复现信息与服务日志至项目仓库,等待官方跟进修复。验证方式为:将文件移回多层子目录后,再次尝试查看原始内容与关联对话调用,确认访问状态是否恢复正常。

来源:FastGPT GitHub issue