定位 RAG 知识库失败的原因

从失败请求开始

保留脱敏问题、用户角色、资料版本、检索配置和预期结果，单独记录检索文档标识、片段和最终回答。不要把凭据或机密文档放入共享排障工单。

现象	先检查的证据	优先修复方向
返回旧规则	来源版本与最近成功导入	修复来源或更新链路
编号或表格值缺失	解析文本、分块边界、元数据	修复解析或检索策略
出现无权文档	调用身份与服务端过滤	先修授权再继续测试
片段正确但回答无依据	提示词、生成参数、引用范围	约束或调整生成
没有批准来源	资料清单与人工复核	拒答或补充获批资料

修改真正出问题的层

文档未进入索引，换模型不能解决；正确片段已返回但被误读时，应固定检索结果比较提示词和模型。把失败样本加入回归集。

资料更新和删除需要测量从源变更到可检索状态的时间。按约定流程验证删除内容从检索和应用缓存中消失，不能只看导入任务显示成功。

用反例完成修复验收

重测原失败与相邻的正常请求，加入无权用户和资料中不存在的信息请求。输出原因、修改、前后证据和剩余限制。模型回答是待验证结果，不能把它对检索过程的解释当作内部运行证据。

官方资料

• Knowledge Bases

文档核验日期：2026 年 10 月 17 日。本文为参考指南，本次未执行真实云端 API 调用。