Mongoose中基于role字段的code条件唯一索引配置异常问题

问题根源 #

你当前的索引配置完全与需求相悖：

• 你设置的partialFilterExpression是当role为manager时，code字段需唯一，但实际需求是仅当role为agent时才需要code唯一。
• 另外，MongoDB的唯一索引会将空字符串""视为有效键值，所以当插入多个role为manager且code为空的文档时，会触发重复键错误。

正确的模型配置 #

调整code字段的索引规则，仅对role: "agent"且code不为空字符串/不为null的文档应用唯一约束：

const userSchema = new mongoose.Schema({
  name: String,
  role: {
    type: String,
    required: true,
  },
  code: {
    type: String,
    required: false,
    index: {
      unique: true,
      // 仅当role为agent且code不为空时，启用唯一约束
      partialFilterExpression: {
        role: "agent",
        code: { $ne: "" },
        code: { $ne: null }
      }
    },
  },
});

配置说明 #

• partialFilterExpression明确了索引生效的条件：只有当用户角色是agent，并且code既不是空字符串也不是null时，才会校验code的唯一性。
• 对于role不为agent的用户（比如manager），无论code是空字符串还是null，都不会触发唯一索引校验，允许多个文档存在相同的空code值。
• 如果业务允许agent的code为null，可去掉code: { $ne: null }这一条件。

注意事项 #

1. 修改索引后，需确保MongoDB已重建该索引。可通过MongoDB Shell执行db.users.reIndex()操作（生产环境建议低峰期执行）。
2. 若之前存在不符合新规则的文档，重建索引时会报错，需先清理冲突数据。

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