升级依赖遇@nestjs/swagger报错：SubClass构造函数需用new调用

问题根源 #

当TypeScript编译目标设为es2021及以上时，useDefineForClassFields会默认启用（TypeScript 4.7+），这会改变类字段的初始化逻辑。旧版本的@nestjs/swagger在处理类属性反射时，未适配这个新逻辑，导致解析类型时错误地将类当作枚举处理，触发Class constructor cannot be invoked without 'new'错误。

具体解决步骤 #

1. 优先升级 @nestjs/swagger 到兼容版本 #

从@nestjs/swagger@6.2.0开始，官方已修复与useDefineForClassFields的兼容问题。执行以下命令升级：

npm install @nestjs/swagger@latest
# 或使用 yarn
yarn add @nestjs/swagger@latest

升级后无需修改其他配置，即可正常使用。

2. 临时替代方案（无法升级依赖时） #

如果因项目限制无法升级依赖，可修改tsconfig.json关闭该配置：

{
  "compilerOptions": {
    "target": "es2021",
    "useDefineForClassFields": false
  }
}

注意：关闭该配置会让类字段回到旧初始化逻辑，可能影响其他依赖对类字段的处理，仅作为临时过渡方案。

3. 显式指定装饰器类型（补充优化） #

若升级或修改配置后仍有问题，可在ApiPropertyOptional中显式指定类型，避免反射解析错误：

export class Child extends Base {
  @ApiPropertyOptional({ type: () => SubClass })
  subClass?: SubClass
}

使用箭头函数的方式能避免循环引用问题，同时确保Swagger正确识别类类型。

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