为何Mongoose中email与survey联合唯一索引未生效？

你遇到的重复插入问题，大概率是唯一索引没正常工作导致的，下面是几个常见原因和排查解决方法：

1. 索引根本没在MongoDB中创建成功 #

Mongoose只会在模型首次初始化时尝试创建Schema中定义的索引。如果你的集合之前就存在，或者模型初始化顺序有问题，可能导致索引没被创建。

• 排查方法：打开MongoDB Shell，执行命令查看集合索引：

  db.participants.getIndexes()
  

  检查结果里有没有{ email: 1, survey: 1 }的唯一索引。
• 解决方法：
  • 手动在数据库中创建索引：

    db.participants.createIndex({ email: 1, survey: 1 }, { unique: true })
    

  • 确保Mongoose的autoIndex选项开启（开发环境默认开启，生产环境建议手动创建索引后关闭该选项）。

2. email字段的特殊值导致约束失效 #

你的email字段设置了required: false，插入时可能出现两种情况：字段值为null，或者字段直接不存在（传入undefined时Mongoose会忽略该字段）。

• 注意：如果两条记录的survey相同，其中一条email是null，另一条没有email字段，这两条在索引中会被判定为重复，应该触发约束；但如果email字段是不同的"空值"（比如一个是空字符串""，一个是null），那自然不会触发约束。
• 排查方法：直接查看数据库中已插入的两条重复记录，确认email和survey字段的值是否完全一致。

3. 模型重复初始化导致索引定义被忽略 #

你代码里用了mongoose.models.Participant || mongoose.model("Participant", ParticipantSchema)来导出模型，如果项目中其他地方已经提前初始化过Participant模型，且当时的Schema没有定义这个复合索引，那么后续的索引定义不会生效——因为Mongoose不会重复创建同一个名称的模型。

• 解决方法：确保项目中所有使用Participant模型的地方，都是基于你当前这个带索引的Schema创建的；或者在开发环境中，先删除已存在的模型再重新创建（仅测试用）：

  delete mongoose.models.Participant;
  module.exports.Participant = mongoose.model("Participant", ParticipantSchema);
  

4. 插入操作的特殊配置或钩子修改了数据 #

比如使用insertMany时设置了ordered: false（但MongoDB依然会检查唯一约束，只是不会因单条错误终止插入），或者代码中的预存钩子（pre hook）修改了email或survey的值，导致实际插入的内容和你传入的不一致。

• 排查方法：检查插入代码的配置，或者在插入后打印返回的文档，确认实际存储的字段值是否符合预期。

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