NestJS中嵌套对象的@Schema装饰器作用是什么？

问题背景 #

我正在学习NestJS和Mongoose，看到一段嵌套Schema的示例代码后，对其中@Schema装饰器的作用产生了疑问。

原示例代码 #

import { Prop, Schema, SchemaFactory } from '@nestjs/mongoose';
import { Document } from 'mongoose';

export type CatDocument = Cat & Document;

@Schema()
export class Owners {
  @Prop()
  names: [string];
}

@Schema()
export class Cat {
  @Prop()
  name: string;

  @Prop()
  age: number;

  @Prop()
  breed: string;

  @Prop()
  owners: Owners;//schema for owner
}

export const CatSchema = SchemaFactory.createForClass(Cat);

我的疑问 #

我知道如果不为Owners类调用SchemaFactory.createForClass()，NestJS不会为它生成独立的Mongoose Schema。那上面代码里给Owners加@Schema()装饰器到底有什么用？是不是应该直接定义普通的Owners类：

export class Owners {
    names: [string];
}

然后在Cat类里这样使用：

@Prop({ type: Owners })
owners: Owners;

解答 #

1. @Schema()在嵌套类中的实际作用 #

给Owners加上@Schema()装饰器，核心是告诉NestJS/Mongoose：这个类是用来定义嵌套Schema结构的载体。哪怕你不为它单独生成独立Schema，当父类Cat通过SchemaFactory.createForClass()生成Schema时，NestJS会自动解析带有@Schema()的嵌套类，把类上的@Prop()配置转化为Mongoose的嵌套子Schema规则。

如果去掉@Schema()，直接用普通类，虽然TypeScript能识别类型，但Mongoose会忽略类里所有@Prop()的配置（比如必填校验、默认值、字段类型约束等），只会把它当成普通JS对象结构，完全浪费了NestJS装饰器的Schema配置能力。

2. 两种写法的核心区别 #

3. 推荐的嵌套Schema写法 #

如果只是需要嵌套子文档（而非独立集合），两种写法都能运行，但更推荐带@Schema()的写法。另外，建议在Cat类的owners字段上显式指定类型，让NestJS更准确地解析结构：

@Prop({ type: Owners })
owners: Owners;

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