NestJS中如何从含必填字段的DTO提取数据到自定义Type？

问题背景 #

在NestJS开发中，使用CreateUserDTO接收请求体时，需要提取部分字段（如排除confirmPassword）传递给Service层，但直接创建自定义类型CreateUserParams会触发TypeScript类型错误：

Argument of type 'CreateUserParams' is not assignable to parameter of type 'CreateUserDTO'. Property 'confirmPassword' is missing in type 'CreateUserParams' but required in type 'CreateUserDTO'.

希望在保持CreateUserDTO中confirmPassword为必填字段的前提下，解决字段提取的类型问题。

可用解决方案 #

方案1：类型断言（Type Assertion）

直接将提取后的对象断言为CreateUserParams，绕过TypeScript的类型检查，适合简单场景：

// users.controller.ts
@Post()
createUser(@Body() createUserDTO: CreateUserDTO) {
  const userDetails = {
    username: createUserDTO.username,
    password: createUserDTO.password,
  } as CreateUserParams;
  this.usersService.createUser(userDetails);
}

注意：这种方式仅做类型层面的声明，不做运行时校验，适合你确定字段必然存在的场景。

方案2：使用TypeScript Pick工具类型

利用TypeScript内置的Pick工具类型，直接从CreateUserDTO中选择需要的字段定义CreateUserParams，避免重复定义类型，同时保持类型同步：

// types.ts
import { CreateUserDTO } from './CreateUser.dto';

// 从CreateUserDTO中选取指定字段生成类型
export type CreateUserParams = Pick<CreateUserDTO, 'username' | 'password'>;

后续修改CreateUserDTO中对应字段的类型时，CreateUserParams会自动同步，无需手动维护。控制器层代码可保持不变，TypeScript会自动识别类型匹配。

方案3：使用Class Transformer（NestJS推荐）

NestJS集成了class-transformer库，适合处理复杂的DTO与业务对象转换场景，还能兼顾后续返回数据时的字段过滤（如排除password、createdAt）：

1. 安装依赖：

npm install class-transformer class-validator

2. 将CreateUserParams定义为类，并实现从DTO转换的方法：

// CreateUserParams.ts
import { plainToInstance } from 'class-transformer';
import { CreateUserDTO } from './CreateUser.dto';

export class CreateUserParams {
  username: string;
  password: string;

  static fromDTO(dto: CreateUserDTO): CreateUserParams {
    return plainToInstance(CreateUserParams, dto);
  }
}

3. 在控制器中调用转换方法：

// users.controller.ts
@Post()
createUser(@Body() createUserDTO: CreateUserDTO) {
  const userDetails = CreateUserParams.fromDTO(createUserDTO);
  this.usersService.createUser(userDetails);
}

这种方式支持运行时字段过滤，后续如果需要返回用户数据时排除敏感字段，也可以用class-transformer的@Exclude装饰器配合plainToInstance实现。

内容的提问来源于stack exchange，提问作者Valentin-Constantin Baltatescu