NestJS使用Mongoose操作MongoDB时如何实现非空字段唯一且允许多个null值

MongoDB的sparse唯一索引只会过滤完全不存在该字段的文档，如果你的文档里mobile字段显式设置为null，依然会被纳入索引校验，多个null值会被判定为重复，触发唯一约束报错。

方案1：使用部分索引（Partial Index）替代sparse索引 #

部分索引可以自定义索引生效的过滤条件，仅当mobile字段为非空有效值时才纳入唯一校验，是当前场景的最优解。
修改你的Schema配置如下：

@Schema()
export class Contact extends Document {
  @Prop({ unique: true, sparse: true, required: true })
  email: string;
  
  @Prop({ default: '+1' })
  countryCode: string;

  @Prop({
    index: {
      unique: true,
      partialFilterExpression: { mobile: { $exists: true, $ne: null } }
    }
  })
  mobile: string;
}

注意：修改索引配置后，需要先删除集合中已存在的旧mobile唯一索引，重启服务后新索引才会生效。

方案2：保留sparse索引，不存储null值的mobile字段 #

如果要继续用sparse索引，只要保证用户未填写手机号时，文档中不存在mobile字段而非存储null即可：

// 保存前中间件，自动移除值为null的mobile字段
@Schema({
  pre: ['save', function(next) {
    if (this.mobile === null) delete this.mobile;
    next();
  }]
})
export class Contact extends Document {
  @Prop({ unique: true, sparse: true, required: true })
  email: string;
  
  @Prop({ default: '+1' })
  countryCode: string;

  @Prop({ 
    unique: true, 
    sparse: true,
    default: undefined // 未传值时不生成该字段
  })
  mobile: string;
}

方案1：新增前置校验逻辑 #

在Mongoose的pre保存钩子、或者Nest的业务层/管道层添加校验：当传入的mobile不为空时，先查询数据库是否已有相同的mobile记录，存在则直接抛出重复错误。

// 示例：Nest Service层校验
async createContact(dto: CreateContactDto) {
  if (dto.mobile) {
    const exists = await this.contactModel.exists({ mobile: dto.mobile });
    if (exists) {
      throw new ConflictException('该手机号已被使用');
    }
  }
  return this.contactModel.create(dto);
}

注意：该方案存在并发风险，若两个相同手机号的请求同时通过校验，还是可能插入重复数据，建议搭配数据库层的唯一约束兜底。

方案2：自定义DTO校验装饰器 #

可以封装Nest的自定义校验装饰器，在DTO层就完成重复校验，逻辑和上述一致，适合多接口复用。

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