解决FastGPT私有部署版自定义分隔符不存在时PDF解析为空的问题

现象

使用FastGPT私有部署版4.9.10-fix，配置本地minerU的PDF增强解析功能，将分段规则设置为自定义并选择不存在的分隔符（如======）。此时解析日志显示正常，知识库页面显示文档已就绪，但该文档下无内容，数据量显示为"-"。

可能原因

自定义分段规则使用的分隔符未在目标PDF文档中出现，导致解析后未生成可入库的有效分段数据。

排查步骤

1. 进入FastGPT知识库的文档管理界面，查看目标文档的分段规则配置。
2. 核对目标PDF文档的实际内容，确认是否存在配置的自定义分隔符。
3. 查看解析日志，确认是否存在分段相关的异常记录。
4. 调整分段规则的分隔符参数。

解决与验证

将自定义分隔符替换为PDF文档中实际存在的分隔符，重新上传文档进行解析。验证时，查看知识库文档列表，确认文档下显示对应的数据量，且可查看解析后的分段内容。

来源： FastGPT 官方来源

适用性与版本范围

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

安全护栏

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

回滚指引

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