如何让TypeScript检测接口新增的可选属性以同步DTO？

核心问题原因 #

TypeScript中类实现接口时，仅强制实现必填属性，可选属性可直接省略，因此接口新增可选属性后，DTO类不会收到编译提示。而NestJS的ValidationPipe默认会过滤掉未添加校验装饰器的属性，导致未同步的属性被自动剥离。

以下是几种可行的解决方案：

方案1：TypeScript类型断言强制完全匹配 #

在DTO类定义后添加一段类型检查代码，强制DTO的实例结构与接口完全一致（包括所有可选属性）：

// 共享types包的接口
export interface CreateBookRequest {
    title: string;
    year?: number;
    author?: string;
}

// 后端DTO类
export class CreateBookRequestDto implements CreateBookRequest {
    @IsString()
    readonly title: string;

    @IsNumber()
    @IsOptional()
    readonly year?: number;
}

// 强制DTO完全匹配接口，新增属性未同步时会触发编译错误
const _ensureFullSync: CreateBookRequest = {} as CreateBookRequestDto;

当接口新增author属性而DTO未同步时，TypeScript会直接抛出类型错误，提示DTO缺少对应属性。

如果需要严格禁止DTO多定义接口没有的属性，可以使用精确匹配工具类型：

// 定义精确匹配类型
type Exact<T, U> = T extends U ? U extends T ? T : never : never;

// 强制DTO与接口完全一致，多/少属性都会报错
const _ensureExactMatch: Exact<CreateBookRequest, CreateBookRequestDto> = {} as CreateBookRequestDto;

方案2：调整NestJS ValidationPipe配置（应急用） #

如果暂时无法同步属性，又不想让未校验的属性被剥离，可以修改ValidationPipe的白名单配置：

// main.ts中全局配置ValidationPipe
import { ValidationPipe } from '@nestjs/common';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  app.useGlobalPipes(new ValidationPipe({
    whitelist: false, // 关闭白名单，允许未添加装饰器的属性通过
  }));
  await app.listen(3000);
}
bootstrap();

注意：此方案会绕过部分校验逻辑，增加安全风险，仅适合临时应急，不推荐长期使用。

方案3：自动生成DTO类（彻底解决） #

使用代码生成工具（如ts-morph）从共享接口自动生成带class-validator装饰器的DTO类，避免手动同步遗漏。核心思路：

1. 编写脚本读取共享types包中的接口文件
2. 解析接口的属性类型、可选性等信息
3. 自动生成对应DTO类代码，匹配添加@IsString()、@IsOptional()等装饰器
4. 每次接口更新后运行脚本同步DTO

这种方案可以彻底消除手动同步的误差，适合大型monorepo项目。

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