故障排查GitHub issue2 分钟阅读故障排查

FastGPT私有部署后PDF增强解析图片自动消失的排错指南

用户使用FastGPT私有部署版本4.9.5、pdf-marker v0.2,上传包含图片的PDF并开启PDF增强解析功能后,初始阶段图片可正常显示,间隔数小时后图片自动消失。 目前无官方明确的触发原因,仅存在用户推测图片资源被自动清除的可能性。

现象

用户使用FastGPT私有部署版本4.9.5、pdf-marker v0.2,上传包含图片的PDF并开启PDF增强解析功能后,初始阶段图片可正常显示,间隔数小时后图片自动消失。

可能原因

目前无官方明确的触发原因,仅存在用户推测图片资源被自动清除的可能性。具体触发逻辑需结合部署环境的存储策略、缓存配置、自动清理规则等实际环境参数确认,暂无可直接匹配的已知问题场景。

排查步骤

  1. 确认当前FastGPT私有部署版本为4.9.5,pdf-marker版本为v0.2,匹配问题触发的环境条件。
  2. 重新上传包含图片的PDF文件,开启PDF增强解析功能,记录初始状态下图片的显示情况。
  3. 间隔数小时后再次访问该解析结果页面,确认图片是否仍正常显示。
  4. 核查部署环境的存储目录、缓存服务配置,检查是否存在自动清理图片资源的规则。

解决与验证

目前无明确的官方解决方案,可按以下方向验证排查结果:

  1. 调整部署环境的自动清理策略,移除可能导致图片资源被误删的规则。
  2. 重新上传测试用的带图片PDF文件,开启增强解析后间隔数小时再次查看,确认图片显示状态是否恢复正常。
  3. 若问题仍存在,可进一步核对部署环境的存储权限、网络传输配置等参数。

来源: FastGPT 官方来源

适用性与版本范围

本页适用于官方来源记录的 故障排查 场景。执行变更前,需核对 FastGPT、依赖、API 与部署版本。

安全护栏

凭证与私密数据使用 [REDACTED_CREDENTIAL] 占位符。执行操作前需核对文档的环境与版本。

回滚指引

恢复变更前的技术内容权威快照、已保存配置与数据快照,再执行最小验证场景。