Nest.js+MongoDB中如何为数组内嵌套文档自动生成_id？

问题原因 #

嵌套文档未自动生成_id，通常是因为嵌套Schema的配置不正确——要么没正确引用子文档的Schema，要么意外关闭了_id自动生成开关。

正确配置步骤 #

1. 定义嵌套子文档Schema #

确保子文档（Group）用@Schema()装饰，生成合法的Mongoose Schema，默认情况下Mongoose会为子文档自动生成_id：

// group.schema.ts
import { Schema, Prop, SchemaFactory } from '@nestjs/mongoose';
import { Document } from 'mongoose';

// 显式开启_id生成（默认就是true，可省略，若之前设过false则必须加上）
@Schema({ _id: true })
export class Group extends Document {
  @Prop({ required: true })
  count: number;
}

export const GroupSchema = SchemaFactory.createForClass(Group);

2. 主文档中正确引用子文档Schema #

在Party主文档的groups字段中，必须将@Prop的type设置为子文档的Schema（GroupSchema），而非直接引用Group类：

// party.schema.ts
import { Schema, Prop, SchemaFactory } from '@nestjs/mongoose';
import { Document } from 'mongoose';
import { Group, GroupSchema } from './group.schema';

@Schema()
export class Party extends Document {
  // 其他业务字段示例
  @Prop({ required: true })
  name: string;

  // 关键：用[GroupSchema]作为type，而非[Group]
  @Prop({ type: [GroupSchema], required: true })
  groups: Group[];
}

export const PartySchema = SchemaFactory.createForClass(Party);

3. 创建文档的正确姿势 #

调用create或save方法时，无需手动给groups数组中的元素添加_id，Mongoose会自动生成：

// party.service.ts
async create(createPartyDto: { name: string; groups: { count: number }[] }) {
  // 直接传入包含count的groups数组即可
  return this.partyModel.create(createPartyDto);
}

常见错误排查 #

• 错误写法：@Prop({ type: [Group], required: true })——直接用Group类而非GroupSchema，Mongoose无法识别为嵌套子文档，不会自动生成_id
• 错误配置：在Group的@Schema()中设置了{ _id: false }，导致关闭自动生成
• 手动传入_id：创建时如果手动给groups元素设置了_id: null或空值，会覆盖自动生成逻辑

内容的提问来源于stack exchange，提问作者Adora González