MongoDB限制复合多键索引仅含一个数组字段，因其底层需将每个索引条目唯一映射到“一个数组元素+其余标量字段值”的组合；若允许多个数组字段，将导致笛卡尔积式条目爆炸，破坏索引一致性与查询语义。
为什么复合多键索引最多只能有一个数组字段
MongoDB 明确禁止在同一个复合索引中包含两个或以上指向数组的路径，比如 { "a": 1, "b": 1 }，而 a 和 b 在文档中都是数组——这种索引创建会直接失败，报错："Multi-key indexes do not support multiple array fields"（MongoDB 4.2+ 版本）。
这不是实现疏漏，而是设计限制：多键索引的底层机制要求每个索引条目能明确映射到“一个数组元素 + 该元素内其他字段值”的组合。一旦两个字段都是数组，交叉组合爆炸（如 a=[1,2], b=[3,4] 就会产生 4 种组合），MongoDB 无法保证索引条目的唯一性和查询语义的可预测性。
- 允许的情况：
{ "items.name": 1, "status": 1 }—— 只有items是数组，status是标量，合法 - 不允许的情况：
{ "tags": 1, "categories": 1 }—— 若两者都是数组，建索引失败 - 插入时也会被拦截：如果已有
{ "items": [1], "attrs": [2] }的复合多键索引，再插入{ "items": [1,2], "attrs": [3,4] }会报错，因为违反“单数组字段”约束
查 items.price 却建了 items 索引，为什么没用
对数组字段建索引时，路径精度决定是否触发 multikey 行为及能否命中查询。只建 { "items": 1 }，MongoDB 确实会建 multikey 索引，但它只覆盖整个 items 数组对象，不展开解析内部字段；而查询 { "items.price": { $gt: 100 } } 需要的是对每个数组元素里 price 字段的独立索引条目。
换句话说：items 索引能加速 find({ items: { $in: ["A", "B"] } }) 这类匹配整个数组元素的查询，但对嵌套字段条件无效。
- 正确做法：建
{ "items.price": 1 }—— MongoDB 自动识别items是数组，生成 multikey 索引并为每个items[i].price建条目 - 验证方式：运行
db.collection.getIndexes()，确认目标索引的"multikey": true且"multikeyPaths"中"items.price"被标记 - 常见陷阱：索引存在但
"multikey": false，说明当前集合里没有含非空items的文档触发自动识别，需插入一条样例再reIndex()（生产环境慎用）
$elemMatch 查询必须配复合索引，单字段索引无效
当你要找数组中“同时满足多个条件”的元素，例如 { items: { $elemMatch: { price: { $gt: 100 }, inStock: true } } }，仅靠 { "items.price": 1 } 或 { "items.inStock": 1 } 都无法生效。MongoDB 不会对两个单字段索引做合并扫描，它需要一条能覆盖全部 $elemMatch 内部字段的复合索引。
原因在于：$elemMatch 要求所有条件落在**同一个数组元素上**，只有复合索引才能保证这些字段值来自同一子文档。
- 必须建：
{ "items.price": 1, "items.inStock": 1 }（顺序无关，但建议按查询频率或选择性排序） - 不能建：
{ "items.price": 1, "status": 1 }—— 因为status不在$elemMatch范围内，无法约束同一数组元素 - 注意：这个复合索引仍是 multikey（因
items是数组），但只含一个数组路径，合法
唯一复合多键索引的特殊行为
在 { "a.loc": 1, "a.qty": 1 } 上建唯一索引时，MongoDB 不是校验整个文档的 a.loc 和 a.qty 组合唯一，而是对每个数组元素单独校验。即：{ a: [ { loc: "A", qty: 5 }, { loc: "A", qty: 5 } ] } 会违反唯一性（同一文档内重复），但 { a: [ { loc: "A", qty: 5 } ] } 和 { a: [ { loc: "A", qty: 5 } ] }（不同文档）是允许的。
这容易被误读为“跨文档唯一”，实际是“每个数组元素的字段组合在各自文档内唯一”。如果你需要跨文档强制唯一，得靠应用层控制或额外字段（如拼接 a.loc + "_" + a.qty 后建唯一单字段索引）。
- 唯一性检查粒度：按数组元素级别，不是按文档或集合级别
- 缺失字段处理：若某元素缺
loc或qty，对应索引条目为null，仍参与唯一性校验（null视为相同值） - 不要指望它替代业务逻辑：比如防止“同一商品在不同 sku 下重复上架”，仍需在写入前查重
$elemMatch 这种看似简单却对索引结构极度敏感的操作——稍不留意，explain() 里就只剩 "stage": "COLLSCAN"。 
