先把当时的情况摆出来。Qdrant 1.12 的集合有 260 万条切片,按 tenant_id 做 filter 查询 limit 10,实际只回 3 条,同一个 query 去掉 filter 能回满。先以为是数据缺失,把命中的 id 逐条反查,文档都在库里,只是凑不够 10 条。
这类报错背后常见的原因有几处,逐个排除就行。带 filter 时 HNSW 走的是过滤后的子图,候选不足就提前结束。少数情况下是tenant_id 没建 payload 索引,过滤只能靠全量扫描后丢弃。
少数情况下是hnsw_ef 用的是默认值,过滤场景下搜索宽度不够。不容易想到的是,租户数据分布很不均匀,小租户的向量簇本身就很稀疏。
动手时先用 REST 复现带 filter 与不带 filter 的差异
curl -s -X POST http://localhost:6333/collections/docs/points/search -H 'Content-Type: application/json' -d '{"vector":[0.12,0.34],"limit":10,"filter":{"must":[{"key":"tenant_id","match":{"value":"t-88"}}]},"params":{"hnsw_ef":256}}'
给过滤字段建 keyword 类型的 payload 索引
curl -X PUT http://localhost:6333/collections/docs/index -H 'Content-Type: application/json' -d '{"field_name":"tenant_id","field_schema":"keyword"}'
然后把 hnsw_ef 调大再对比返回条数
curl -s -X POST http://localhost:6333/collections/docs/points/search -H 'Content-Type: application/json' -d '{"vector":[0.12,0.34],"limit":10,"params":{"hnsw_ef":512,"exact":false}}'
等前面都确认过,再用精确检索跑一次基准,确认 top10 的正确答案
python eval_recall.py --collection docs --tenant t-88 --exact
别只看报错消失,验证要多做一步。带 filter 的查询稳定返回 10 条,与 exact 模式的前 10 条重合度在 9 条以上,小租户也不再出现空结果。
过滤检索不是简单的先筛后搜,payload 索引与 hnsw_ef 要一起调,倾斜严重的租户最好单独建集合。这类问题最好一次改到位,反复小改反而容易把原因搅混。
