NestJS中MongoDB嵌入文档引发重复键错误，求解决方案

问题场景 #

在MongoDB与NestJS开发中，定义了两个Schema：X和Y。
X的Schema用于独立文档，配置了邮箱唯一性约束：

export class X{
  @Prop({required:true,unique:true})
  email:string
}

该配置原本用于阻止创建独立X文档时出现重复邮箱。

Y的Schema中嵌入了X类型的字段：

export class Y{
  @Prop({})
  name : string;

  @Prop({required:true})
  x : X 
}

创建第一个嵌入X的Y文档时正常，但创建另一个名称不同但嵌入相同X内容的Y文档时，触发E11000 duplicate error错误，提示x.email重复。

问题原因 #

• NestJS底层依赖Mongoose处理MongoDB Schema，当将X作为嵌入类型复用在Y的Schema中时，Mongoose会完整继承X的所有字段约束，包括unique:true。
• MongoDB的唯一索引是集合级别的，Mongoose会根据继承的约束，自动在Y集合的x.email路径上创建唯一索引。这就导致整个Y集合内，所有文档的x.email值都不能重复，哪怕只是嵌入相同内容而非创建独立X文档。

解决方法 #

若要保留嵌入方式并避免该问题，可通过以下两种方式阻止MongoDB在Y集合的x.email上创建唯一索引：

方案1：拆分Schema，区分独立文档与嵌入场景 #

创建两个不同的Schema类，一个用于独立的X文档（保留unique:true），另一个专供Y嵌入使用（移除unique:true）：

// 独立文档用X Schema
export class X {
  @Prop({required:true,unique:true})
  email:string
}

// Y嵌入用XEmbed Schema
export class XEmbed {
  @Prop({required:true})
  email:string
}

// Y的Schema使用XEmbed
export class Y{
  @Prop({})
  name : string;

  @Prop({required:true})
  x : XEmbed 
}

方案2：在Y的Schema中显式覆盖嵌入字段约束 #

在Y的x字段配置中，直接定义嵌入文档的Schema规则，显式关闭unique约束：

import { Schema as MongooseSchema } from 'mongoose';

export class Y{
  @Prop({})
  name : string;

  @Prop({
    required:true,
    type: MongooseSchema.Types.Object,
    schema: new MongooseSchema({
      email: { type: String, required: true } // 仅保留必填，去掉唯一约束
    })
  })
  x : X 
}

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