Milvus 检索 nprobe 128 仍召回为空怎么排查索引

现象

集合里有十二万条向量,用 searCh 查 top_k=5,返回的 results 是空数组,不报错。把 nprobe 从 16 调到 128 仍然为空,换一个查询向量结果一样,但用主键查单条记录又能查到。

原因

向量检索为空通常不是索引参数问题,而是数据没真正可查。常见情况有三种:集合创建后没有 load,索引建在错误的字段上,或者查询带了过滤表达式,把候选集过滤成了空。还有一种容易被忽略,数据写进了别的 partition,而查询只搜默认分区。

解决步骤

第一步,确认集合已加载且数量正确。查集合统计和加载状态,num_entities 为 0 或者 load_state 不是 Loaded,都说明问题不在 nprobe。

from pymilvus import Collection
c = Collection("docs")
c.load()
print(c.num_entities, c.load_state)
print(c.partitions)

第二步,去掉过滤条件做对照。先用空 expr 查一次,再把原来的 filter 单独执行 count,确认过滤字段的值和类型一致。字符串字段写成数字、日期格式不统一,都会让候选集变成空。

第三步,检查索引和搜索参数。用 describe_index 看索引建在哪个字段、类型是否为 IVF_FLAT 或 HNSW;IVF 类索引的 nprobe 不能超过 nlist,参数越界时部分版本会静默返回空。

验证

用一条已知向量查 top1,返回的主键应与写入时一致;把 nprobe 从 16 提到 64,recall 应有提升而不是始终为空,说明索引和参数都已生效。

小结

召回为空先怀疑数据可查性,再怀疑过滤条件,最后才调 nprobe。load、分区、字段类型这三项核对完,大多数空结果都能定位。

您可以还会对下面的文章感兴趣: