企业知识库搭好了却搜不到：五个原因

2026-09-12 更新 · 深圳市鼎铂智能科技有限公司

这是知识库上线之后最常见的一类故障，也是最难查的一类——因为它不报错。文档显示上传成功，后台一片绿，就是在对话里问不出来。下面五个原因都是我们在生产上真排查过的，按从外到内的顺序排。

一、磁盘写满了，向量库悄悄转成只读

最外层也最容易被忽略的一条。机器磁盘被别的东西写满，向量库自动进入只读，新内容根本写不进去，而上传界面照样显示成功。表现就是「老内容搜得到、这周加的一条都搜不到」。查之前先看一眼磁盘水位，能省下几个小时。这条和其他私有化部署的坑我们单写过一篇：Dify 私有化部署：装完才是开始。

二、文档发布了，但这个库没挂进那个应用

这是两个互相独立的开关，很容易只做一半：文档本身要处于发布状态，这个知识库还要被挂进那个应用的检索范围里。只做前一件，后台全是绿的，内容永远搜不到。

三、多轮之后，查询被改写带偏了

带查询改写的应用要留神这个：聊了几轮之后，改写节点容易被前面的对话历史带偏，把用户这一轮的原话改成另一个意思，检索自然落空。典型表现是「第一轮能搜到，聊几轮之后同一个问题就搜不到了」。把改写之后的那句查询打进日志，拿真实的多轮对话跑一遍肉眼比对，一眼就能看出来。

四、切分把答案切断了

一条完整答案跨了两个片段，检索命中上半段，下半段没被带出来，模型就答了半截。这类最阴险，因为它看上去是答了，只是答得不全，业务方往往以为是模型笨。

对策是按语义和标题切，别让一个完整条目被切开；FAQ 这类内容最稳的形式是一问一答独立成段。切分方式改了之后要重新入库，光改配置不重跑没用。

五、库里同时躺着新旧两个版本

旧文档没下架，新政策也进来了，检索同时召回两条，模型按哪条答全看运气。这比搜不到更糟——它看起来像答对了，实际给客户的是已经作废的口径。

解法不在检索侧，在管理侧：每条知识要有明确的生效状态，更新时旧版必须下架，而不是再传一份新的上去。

把验收动作固定成三步

1. 拿一个真实问题在应用里搜一次，确认召回结果里有这条新内容——别只看知识库后台的对勾。
2. 把召回到的原文打出来肉眼对一遍，确认命中的是完整那一段，不是半截。
3. 每次加完知识，跑一遍以前答得对的老问题，确认没被新内容挤掉。

这三步花不了十分钟，但省掉的是「上线两周后才发现客户一直拿到旧政策」这种事。