Mongoose在什么阶段会为MongoDB创建索引？

索引默认创建时机 #

Mongoose 默认会在模型首次初始化、MongoDB 连接建立成功后，自动为 Schema 中定义的所有索引（包括 unique 索引）调用 MongoDB 的 createIndex 接口完成创建。

新增 unique 索引不生效的常见原因 #

• 集合中已存在对应字段的重复值：unique 是 MongoDB 侧的约束，如果创建索引时集合内已有重复的字段值，MongoDB 会直接拒绝索引创建请求，这是最常见的故障原因。
• 关闭了自动索引配置：如果全局连接配置中设置了 { autoIndex: false }，或者单个 Schema 定义时传入了 { autoIndex: false } 选项，Mongoose 会停止自动创建索引的逻辑，需要手动触发创建。
• 已存在同字段的旧索引：如果该字段之前已经创建过非唯一的普通索引，且没有删除，新的 unique 索引创建请求会被 MongoDB 忽略。

索引是否只会创建一次 #

是的。MongoDB 的 createIndex 接口本身是幂等的：如果目标索引已经存在，不管调用多少次接口，都不会重复创建，也不会修改原有索引的配置。

问题排查解决步骤 #

1. 打开 Mongoose 调试日志确认错误：添加代码 mongoose.set('debug', true) 后重启服务，查看控制台输出的索引创建报错信息，可以直接定位问题。
2. 清理重复数据：如果是重复值导致的索引创建失败，先清理集合中对应字段的重复数据，再重新触发索引创建。
3. 手动触发索引创建：如果关闭了 autoIndex 配置，可以手动执行 await 你的模型名.createIndexes() 完成索引创建，生产环境建议在业务低峰期操作，避免大集合建索引锁表影响业务。
4. 直接通过 MongoDB Shell 验证：连接数据库后执行 db.你的集合名.getIndexes() 查看现有索引，若目标索引不存在，可手动执行 db.你的集合名.createIndex({目标字段: 1}, {unique: true}) 查看具体报错。

内容的提问来源于stack exchange，提问作者YulePale