Mongoose索引配置需求：唯一值且允许Null/空值

用户创建预订时可选择填写邮箱、电话或WhatsApp作为联系方式，核心需求：

1. 已填写的联系方式必须全局唯一，防止刷单
2. 未填写的字段允许为Null或空值，且空值不会触发「重复键」错误
3. 参考Stack Overflow示例实现的方案（单独字段加带partialFilterExpression的唯一索引），虽允许了Null值，但无法阻止重复的联系方式提交，问题未解决

当前使用的Mongoose Schema：

const BookingSchema = new mongoose.Schema({
  fullName: {
    type: String,
    required: true
  },
  createdAt: {
    type: Date,
    default: Date.now
  },
  email: {
    type: String,
    trim: true,
    index: {
      unique: true,
      partialFilterExpression: {email: {$type: 'string'}},
    },
    set: v => (v === '' ? null : v),
  },
  phone: {
    type: String,
    trim: true,
    index: {
      unique: true,
      partialFilterExpression: {phone: {$type: 'string'}},
    },
    set: v => (v === '' ? null : v),
  },
  whatsapp: {
    type: String,
    trim: true,
    index: {
      unique: true,
      partialFilterExpression: {whatsapp: {$type: 'string'}},
    },
    set: v => (v === '' ? null : v),
  },
})

场景1：每个联系方式字段各自唯一 #

如果你的需求是「邮箱值唯一、电话值唯一、WhatsApp值各自独立唯一」，当前Schema的逻辑本身是正确的，但可能存在以下问题导致重复值无法被拦截：

1. 索引未正确创建 #

先通过MongoDB命令确认索引是否生效：

db.bookings.getIndexes()

如果对应字段的唯一索引不存在，需要重新同步Schema到数据库（可以删除旧集合重启服务，或手动创建索引）。

2. 大小写/格式不一致导致重复 #

• 邮箱字段：默认情况下MongoDB索引区分大小写，比如Test@Example.com和test@example.com会被视为不同值。可以添加collation配置忽略大小写：

  email: {
    type: String,
    trim: true,
    index: {
      unique: true,
      partialFilterExpression: {email: {$type: 'string'}},
      collation: { locale: 'en', strength: 2 } // 忽略大小写差异
    },
    set: v => (v === '' ? null : v),
  }
  

• 电话/WhatsApp字段：用户可能提交带区号、空格或特殊符号的号码，导致相同号码被视为不同值。需要在set函数中统一格式：

  phone: {
    type: String,
    trim: true,
    index: {
      unique: true,
      partialFilterExpression: {phone: {$type: 'string'}},
    },
    set: v => {
      if (!v) return null;
      // 移除所有非数字字符，统一格式（根据业务需求调整区号规则）
      return v.replace(/\D/g, '');
    },
  }
  

场景2：用户只能提交一种联系方式且全局唯一 #

如果需求是「用户只能填写邮箱、电话、WhatsApp中的一个，且该值在所有预订中唯一」，需要使用稀疏联合唯一索引：

const BookingSchema = new mongoose.Schema({
  fullName: {
    type: String,
    required: true
  },
  createdAt: {
    type: Date,
    default: Date.now
  },
  email: {
    type: String,
    trim: true,
    set: v => (v === '' ? null : v),
  },
  phone: {
    type: String,
    trim: true,
    set: v => {
      if (!v) return null;
      return v.replace(/\D/g, '');
    },
  },
  whatsapp: {
    type: String,
    trim: true,
    set: v => {
      if (!v) return null;
      return v.replace(/\D/g, '');
    },
  },
})

// 创建联合稀疏唯一索引，确保存在的联系方式字段值唯一
BookingSchema.index(
  { email: 1, phone: 1, whatsapp: 1 },
  {
    unique: true,
    sparse: true,
    partialFilterExpression: {
      $or: [
        { email: { $type: 'string' } },
        { phone: { $type: 'string' } },
        { whatsapp: { $type: 'string' } }
      ]
    }
  }
)

必加：业务层前置校验 #

数据库索引是最后一道防线，建议在业务层添加前置校验，提前拦截重复值并返回友好提示：

async function createBooking(bookingData) {
  // 检查邮箱重复
  if (bookingData.email) {
    const existing = await Booking.findOne({ email: bookingData.email });
    if (existing) throw new Error('该邮箱已被使用');
  }
  // 检查电话重复
  if (bookingData.phone) {
    const existing = await Booking.findOne({ phone: bookingData.phone });
    if (existing) throw new Error('该电话已被使用');
  }
  // 检查WhatsApp重复
  if (bookingData.whatsapp) {
    const existing = await Booking.findOne({ whatsapp: bookingData.whatsapp });
    if (existing) throw new Error('该WhatsApp账号已被使用');
  }

  return await Booking.create(bookingData);
}

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