首页/AI/RAG 与向量库速查/向量索引常见问题清单
Embedding 与检索50 条

向量索引常见问题清单

索引层的高频问题:度量与索引类型不匹配、删除后未整理、分片或参数配置不当、过滤字段无索引导致退化、批量写入后未 flush 导致数据不可见;排查时按数据可见性与召回分层定位。

RAG 与向量库速查AI更新于 2026-10-12

症状与排查方向

症状先查
刚写入就搜不到是否已 flush/refresh,可见性是否延迟
偶发召回骤降索引重建中、分片异常、nprobe/efSearch 被改
过滤后结果为空过滤字段是否有索引,是否触发后过滤
分数整体变差度量/模型/归一化是否被改动

排查入口示例

排查入口示例
print(client.get_collection_stats("kb"))     # 文档数是否等于预期
print(index.nprobe, index.ntotal)             # FAISS 参数与总量
# 用固定查询跑冒烟测试,确认索引可用
数据可见性与召回质量分开排查:先确认能搜到,再评估搜得准不准。

易错点

  • 只看服务日志没有报错就默认索引正常,召回问题多数静默发生
  • 重建索引期间未做双写或别名切换,查询命中空索引

数据来源与参考

  • Milvus 官方文档(故障排查与一致性)
  • FAISS wiki(Index 概览)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌