为何使用class-transformer的plainToInstance无法正确映射响应到DTO？

云上老周

2026-6-19

解决class-transformer plainToInstance返回多余字段的问题

问题原因

plainToInstance默认不会自动过滤原始对象中DTO未定义的字段，需要显式配置选项并配合装饰器标记需要保留的字段。

解决方案

1. 修改DTO，添加`@Expose`装饰器

给DTO中需要保留的字段添加class-transformer的@Expose装饰器，明确标记哪些字段需要被映射：

import { IsDate, IsString } from "class-validator";
import { Expose } from "class-transformer";

export class CreateContainerDto{
    @Expose()
    @IsString()
    etag: string;

    @Expose()
    @IsString()
    requestId: string;

    @Expose()
    @IsDate()
    date: Date;
}

2. 调用`plainToInstance`时添加配置选项

在调用plainToInstance时传入{ excludeExtraneousValues: true }，开启额外字段过滤：

async createContainer(@Query('name') name:string): Promise<CreateContainerDto>  {
    console.log(name);
    
    try{
        const res = await this.imageService.createContainer(name);
        const dto = plainToInstance(CreateContainerDto, res, { 
            excludeExtraneousValues: true 
        });
        console.log(res);
        console.log(dto);
        return dto;
    } catch (error) {
        throw error;
    }
}