必须用完整点号路径创建索引，如{"user.profile.settings.theme": 1}；确认路径需逐层核对大小写与结构；复合索引须遵循ESR原则；数组字段需配合$elemMatch才生效；通过explain验证IXSCAN。
要在MongoDB中精准加速对深层嵌套字段（如{"user": {"profile": {"settings": {"theme": "dark"}}}}中的theme）的查询，必须用完整点号路径创建索引，任何省略、大小写错误或结构误判都会导致索引完全失效。
确认嵌套路径的精确字符串形式
打开MongoDB Shell或Compass，运行db.collection.findOne()查看原始文档结构，逐层核对键名拼写、大小写、有无空格和点号位置；例如user.Profile.Settings.theme与user.profile.settings.theme是两个互不兼容的路径。
注意：若字段值为null、缺失或数组，该文档对应索引项会被跳过——这不影响查询结果正确性，但会降低索引命中率。
复制任意一个匹配文档，粘贴到文本编辑器中，用查找功能确认目标字段的**完整层级路径**，比如order.items.product.id，中间不能漏掉items或product任一层。
使用createIndex()创建单字段路径索引
在Shell中执行：db.collection.createIndex({"user.profile.settings.theme": 1})，其中1表示升序，也可用-1降序。
【必须严格使用双引号包裹完整路径字符串】不能写成{user.profile.settings.theme: 1}（未加引号会被解析为变量）、也不能写成{"theme": 1}（MongoDB不理解对象语义，只认字符串键）。
这一步操作起来很简单，直接把上面确认好的路径字符串填进大括号里就行。
使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
为复合查询构建符合ESR原则的嵌套复合索引
若常见查询同时包含等值、排序、范围条件，例如：{ "status": "paid", "order.items.total": { $gte: 100 }, "order.items.product.category": "electronics" }，需按顺序组织字段：
- 第一步：将等值字段
"status"放在最前； - 第二步：将范围字段
"order.items.total"紧随其后； - 第三步：将等值字段
"order.items.product.category"放在最后——因为$gte已使后续字段无法参与范围裁剪，但它仍可用于等值过滤。
最终命令为：db.collection.createIndex({ "status": 1, "order.items.total": 1, "order.items.product.category": 1 })。
如果order.items是数组，且你用$elemMatch查内部对象，那order.items.product.category建索引才有效；只对order.items建索引毫无作用。
验证索引是否生效
执行db.collection.getIndexes()，检查输出中是否存在你刚创建的路径索引条目。
运行带.explain("executionStats")的查询，例如：db.collection.find({"user.profile.settings.theme": "dark"}).explain("executionStats")，观察executionStages.stage是否为IXSCAN，且nReturned远小于totalDocsExamined。
若stage显示COLLSCAN，说明索引未被使用——立刻回头检查路径字符串是否大小写一致、有无多余空格、是否误用了$expr包装。
