MongoDB对数组字段建普通索引时自动创建多键索引，前提是至少一个文档中该字段为数组；需用db.collection.find({field: {$type: "array"}})验证数组存在，且多键索引不可降级，分片键禁止使用多键字段。
多键索引会自动创建，但必须确认字段确实是数组
MongoDB 在你对数组字段建立普通索引时，会自动将其升级为多键索引（multikey index），无需显式声明。关键前提是：被索引的字段在至少一个文档中是数组类型。如果字段值是单个字符串、数字或对象，哪怕其他文档里是数组，MongoDB 也不会建多键索引——它只看实际数据，不看 schema。
常见错误现象：db.collection.getIndexes() 显示 "multikey" : false，但你确信字段存了数组。原因通常是：集合里所有匹配文档的该字段当前都不是数组（比如全为 null、missing 或标量值）；或者你索引的是嵌套路径（如 "tags.name"），而该路径下没有数组元素。
- 用
db.collection.find({ "tags": { $type: "array" } }).limit(1)确认数组数据真实存在 - 避免对可能为
null或缺失的字段直接建索引；先确保有至少一条含非空数组的文档 - 如果字段是嵌套数组（如
{"meta": [{"id": 1}, {"id": 2}]}），索引路径应为"meta.id"，不是"meta"
使用 createIndex() 创建时无需额外参数
语法和普通索引完全一样，MongoDB 自动识别并标记为多键。例如：
db.posts.createIndex({ "tags": 1 })
只要 tags 字段在任意文档中是数组（如 ["mongodb", "index"]），这个索引就会变成多键索引。你不能强制指定 "multikey": true —— 这个选项只读，由 MongoDB 内部决定。
- 复合索引也适用：如
db.posts.createIndex({ "status": 1, "tags": 1 })，只要tags是数组，整个索引就是多键的 - 升序（
1）、降序（-1）、文本（"text"）等类型都支持多键，但地理空间索引（"2dsphere"）本身已隐含多键行为，不单独归类 - 注意性能影响：多键索引会导致每个数组元素生成一条索引条目，数组越长、文档越多，索引体积越大、写入越慢
检查是否生效：看 multikey 和 multikeyPaths
运行 db.collection.getIndexes() 后，重点看两个字段：
-
"multikey": true表示该索引整体是多键的 -
"multikeyPaths"对象告诉你具体哪些字段路径触发了多键行为，例如：{ "tags": [true], "comments.author": [true] }—— 说明tags和comments.author都是数组字段
如果 "multikeyPaths" 是空对象 {}，即使 "multikey": true，也意味着多键性来自旧版本遗留或内部机制，现代写法中应以 "multikeyPaths" 为准。
容易踩的坑：explain("executionStats") 中看到 "stage": "IXSCAN" 但查询仍慢？可能是数组太大导致索引条目爆炸，或查询条件没利用到数组元素的精确匹配（如用了 $elemMatch 但索引路径不对）。
删除或重建索引前，留意多键限制
一旦索引变成多键，就不能再通过 dropIndex() + createIndex() “降级”回非多键——只要历史数据里出现过数组，新索引依然会被标记为多键。唯一清零方式是：清空集合，再重建索引。
- 不要依赖
collMod或其它命令绕过这个限制；MongoDB 不允许手动修改multikey标志 - 如果误建了多键索引且影响写入性能，优先考虑缩小数组长度（如截断标签列表）、改用引用代替内嵌数组，或引入单独的关联集合
- 分片集群中，多键索引字段不能作为分片键（shard key），这是硬性限制，否则插入会报错：
"cannot shard collection with multikey index"
最常被忽略的一点：多键索引的“自动性”是双刃剑——它省去了手动开关，但也意味着你无法仅靠索引定义判断行为，必须查数据、看 multikeyPaths、测查询计划。
