NestJS Swagger嵌套DTO不生效问题求助

问题核心是TypeScript泛型类型擦除导致Swagger无法自动识别数组内的对象类型，以下是无需手动维护example的解决方案：

1. 给Lesson类添加Swagger字段装饰器
   先确保你的Lesson DTO每个字段都用@ApiProperty()标记，让Swagger能识别字段元数据：

   import { ApiProperty } from '@nestjs/swagger';
   
   export class Lesson {
     @ApiProperty()
     id: string;
   
     @ApiProperty()
     title: string;
   
     @ApiProperty()
     duration: number;
   }
   

2. 在父DTO中显式指定数组元素类型
   包含lessons字段的父DTO里，不能直接写type: [Lesson]，要使用箭头函数返回类型来保留编译时的元数据：

   import { ApiProperty } from '@nestjs/swagger';
   import { Lesson } from './lesson.dto';
   
   export class CourseResponseDto {
     @ApiProperty()
     id: string;
   
     @ApiProperty()
     name: string;
   
     // 关键：用箭头函数传递类型，避免泛型擦除导致Swagger识别失败
     @ApiProperty({ type: () => [Lesson] })
     lessons: Lesson[];
   }
   

3. 确认Swagger模块配置正常
   确保你的AppModule中正确初始化Swagger，启用类型反射：

   import { Module } from '@nestjs/common';
   import { SwaggerModule, DocumentBuilder } from '@nestjs/swagger';
   import { AppController } from './app.controller';
   import { AppService } from './app.service';
   
   @Module({
     imports: [],
     controllers: [AppController],
     providers: [AppService],
   })
   export class AppModule {
     configure(consumer: MiddlewareConsumer) {
       const config = new DocumentBuilder()
         .setTitle('Course API')
         .setDescription('课程API文档')
         .setVersion('1.0')
         .build();
       const document = SwaggerModule.createDocument(this, config);
       SwaggerModule.setup('api', this, document);
     }
   }
   

这种方式完全基于DTO类的元数据自动生成Swagger文档，后续修改Lesson的字段时，Swagger会自动同步更新，不需要手动维护example，适合大型项目场景。

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