mongodb 7.0 支持复合通配符索引但必须用 createindexes 命令显式创建，因 createindex() 辅助方法解析 "$**" 不完整，会静默丢弃通配符部分；正确做法是调用 db.runcommand({createindexes:...}) 并指定 name，且查询需满足前缀匹配（如 tenantid + customfields 子路径）。
MongoDB 7.0 支持复合通配符索引，但必须用 createIndexes 命令显式创建，createIndex() 辅助方法不支持带通配符的复合索引（会静默忽略通配符部分或报错）。
为什么不能直接用 db.collection.createIndex()？
createIndex() 是 shell 辅助方法，它底层调用 createIndexes 命令，但对通配符语法（如 "customFields.$**"）的解析不完整。实测中，若在 createIndex() 中混用普通字段和通配符字段，MongoDB 可能只创建前半部分（如 tenantId: 1），而丢弃 "customFields.$**": 1 —— 不报错，但索引无效。
- 错误现象：
db.salesData.createIndex({ tenantId: 1, "customFields.$**": 1 })执行后，db.salesData.getIndexes()显示只有{ tenantId: 1 }单字段索引 - 根本原因：辅助方法未正确序列化通配符键路径，导致服务端收到的
key字段缺失$** - 正确做法：绕过辅助方法，直调
db.runCommand({ createIndexes: ... })
如何用 createIndexes 命令创建复合通配符索引？
必须将通配符字段（如 "customFields.$**"）和普通字段（如 tenantId）一起写进 key 对象，并指定 name —— 名称不可省略，否则命令失败。
- 示例命令（在
salesData集合上）：db.runCommand({ createIndexes: "salesData", indexes: [{ key: { tenantId: 1, "customFields.$**": 1 }, name: "tenant_customFields_wildcard" }] }) -
tenantId: 1是标准升序字段，"customFields.$**": 1表示递归索引customFields下所有嵌套字段（包括数组内对象的字段） - 排序方向必须一致（都为
1或都为-1），混合方向（如tenantId: 1, "customFields.$**": -1）会导致Command failed with error 28 (InvalidOptions)
哪些查询能命中这个索引？
该索引仅支持「前缀匹配」查询：必须包含 tenantId 等非通配符字段作为查询条件起点，再加通配符字段的任意子路径。
- ✅ 命中：
db.salesData.find({ tenantId: 123, "customFields.addr": "Beijing" }) - ✅ 命中：
db.salesData.find({ tenantId: 123, "customFields.blockId": { $gt: 100 } }) - ❌ 不命中：
db.salesData.find({ "customFields.name": "Alice" })（缺少tenantId） - ❌ 不命中：
db.salesData.find({ tenantId: 123, status: "active" })（status不在customFields内）
容易被忽略的兼容性与性能细节
复合通配符索引在 7.0+ 有效，但实际使用中几个硬约束常被跳过：
- 每个集合最多 64 个索引，而一个复合通配符索引会占用 1 个名额——但它替代的是多个单字段索引，所以整体更省配额
- 通配符部分默认不索引
_id，如果查询里含_id和通配符字段组合（如{ _id: ..., "customFields.x": ... }），需手动在wildcardProjection中声明，但复合通配符索引不支持该选项，只能另建单独索引 - 写入开销比普通复合索引高：每次插入/更新
customFields下任意新字段，都要触发索引条目追加，尤其当文档嵌套深、数组多时，延迟明显
