部分索引是仅对满足指定filter条件的文档建立索引条目,相比普通索引体积更小、写入开销更低,但查询必须带相同或超集过滤条件才能命中,且不支持无匹配条件的sort/count操作。

什么是部分索引,它和普通索引有什么关键区别?
部分索引只对满足指定 filter 条件的文档建立索引条目,而不是扫描整个集合。这意味着:
- 索引体积更小,写入开销更低,内存占用更少
- 查询时只有带上相同过滤条件(或其超集)才能命中该索引
- 不能用于
sort或count等不带匹配条件的操作,除非查询谓词能被索引过滤器逻辑蕴含
比如你有个订单集合,只想加速「已支付且未发货」的订单查询,就不该给全部 status 字段建索引,而应限定范围。
如何用 createIndex 正确创建部分索引?
MongoDB 从 3.2 开始支持部分索引,语法是通过 partialFilterExpression 选项指定条件:
db.orders.createIndex(
{ "userId": 1, "createdAt": -1 },
{
"partialFilterExpression": {
"status": "paid",
"shipped": false
}
}
)注意几个实操要点:
-
partialFilterExpression中只能使用严格相等({ status: "paid" })、存在性({ tags: { $exists: true } })、以及$in、$gt/$gte等可被索引覆盖的表达式;不支持$regex、$text或嵌套$and/$or - 过滤字段本身不必出现在索引键中,但若查询中用到它,建议加入索引键以避免额外文档扫描
- 如果你已有全量索引,删掉它再建部分索引前,务必确认所有相关查询都已适配过滤条件,否则会直接退化为 collection scan
哪些场景下部分索引反而会失效或变慢?
部分索引不是“自动优化开关”,它对查询条件非常敏感:
- 查询时没带
status: "paid",哪怕只查{ userId: 123 },这个索引完全不会被选中 - 使用
$ne或$not会导致无法利用部分索引(MongoDB 无法反向推导过滤器逻辑) - 聚合管道中,如果
$match阶段的条件不能被partialFilterExpression蕴含(比如写成{ status: { $in: ["paid", "refunded"] } },但索引只定义了"paid"),索引也不会生效 - 在分片集群中,部分索引必须与分片键兼容,否则可能在某些 shard 上无数据可索引,导致计划器误判
验证部分索引是否真正生效?
别只看 explain("executionStats") 里有没有 indexName,重点看这几项:
-
executionStats.nReturned是否接近预期结果数(排除误扫) -
executionStats.totalKeysExamined应明显小于totalDocsExamined -
executionStats.executionStages.stage是IXSCAN,且indexBounds显示实际使用的范围合理 - 运行
db.orders.getIndexes()确认partialFilterExpression字段存在且值正确
部分索引的威力取决于你对业务查询模式的精确抽象——漏掉一个常见状态、多加一个看似无害的 $or,就可能让整个索引沉默。


















