现象
在FastGPT 4.9.13私有部署版本中，使用知识库过滤功能时，若输入searchText（搜索关键词），parentId参数会失效。进入指定文件夹后进行字段搜索，会返回不在该文件夹内的知识库条目，查询结果包含全量知识库内容。
可能原因
代码逻辑中，当存在searchKey（搜索关键词）时，查询参数的合并逻辑为：返回包含datasetPerQuery、teamId以及searchMatch的合并对象，其中searchMatch会覆盖datasetPerQuery中的配置。parentId相关的过滤条件属于datasetPerQuery的内容，因此被searchMatch覆盖，导致parentId过滤失效。
排查步骤
- 确认当前部署的FastGPT版本为4.9.13。
- 检查知识库搜索请求中是否同时传入了searchText（对应searchKey）和parentId参数。
- 定位后端代码中处理搜索查询参数拼接的逻辑，查看包含searchKey判断的代码段。
解决与验证
解决方法需调整参数合并逻辑，保留datasetPerQuery中的parentId等原有过滤条件，避免被searchMatch完全覆盖。验证时，同时传入searchText和parentId参数，确认搜索结果仅返回指定文件夹内匹配搜索关键词的知识库条目，不再出现跨文件夹的结果。
来源： FastGPT 官方来源
适用性与版本范围
本页适用于官方来源记录的 故障排查 场景。执行变更前，需核对 FastGPT、依赖、API 与部署版本。
安全护栏
凭证与私密数据使用 [REDACTED_CREDENTIAL] 占位符。执行操作前需核对文档的环境与版本。
回滚指引
恢复变更前的技术内容权威快照、已保存配置与数据快照，再执行最小验证场景。