NestJS如何仅在JSON请求层修改DTO参数的映射名称而不全局生效

问题原因说明 #

你之前遇到productUuid为null的核心原因是Nest默认的ValidationPipe没有开启transform配置，@Expose的别名规则没有触发。而@Expose默认会同时作用于「请求反序列化（普通JSON转DTO实例）」和「响应序列化（DTO实例转JSON）」两个阶段，所以会全局生效。

可用方案（满足仅请求入参转换，不影响项目内使用） #

方案1：最小改动调整装饰器+管道配置 #

该方案仅需调整两处代码，无需额外自定义逻辑：

1. 给@Expose增加toClassOnly: true配置，指定别名仅在请求反序列化阶段生效，响应序列化、项目内DTO调用都不受影响

// create-token.dto.ts
import { Expose } from 'class-transformer';
import { IsString, IsNotEmpty, Length } from 'class-validator';

export class CreateTokenDto {
  @IsString()
  @IsNotEmpty()
  @Length(36)
  @Expose({ name: 'product_uuid', toClassOnly: true })
  productUuid: string;
}

2. 开启全局ValidationPipe的transform配置，让Nest自动触发class-transformer的转换逻辑

// main.ts
import { NestFactory } from '@nestjs/core';
import { ValidationPipe } from '@nestjs/common';
import { AppModule } from './app.module';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  app.useGlobalPipes(new ValidationPipe({
    transform: true, // 开启入参自动转DTO实例
    whitelist: true, // 自动过滤DTO未声明的多余参数，推荐开启
  }));
  await app.listen(3000);
}
bootstrap();

方案2：自定义参数装饰器（完全隔离其他逻辑） #

如果不想修改全局管道配置，仅需要给个别接口做参数转换，可以自定义专用的参数装饰器：

1. 实现自定义装饰器

// src/common/decorators/snake-to-camel-body.decorator.ts
import { createParamDecorator, ExecutionContext, BadRequestException } from '@nestjs/common';
import { plainToInstance } from 'class-transformer';
import { validate } from 'class-validator';

export const SnakeToCamelBody = createParamDecorator(
  async (dto: new () => any, ctx: ExecutionContext) => {
    const request = ctx.switchToHttp().getRequest();
    // 转换入参为DTO实例
    const dtoInstance = plainToInstance(dto, request.body, {
      exposeDefaultValues: true,
    });
    // 执行参数校验
    const errors = await validate(dtoInstance);
    if (errors.length) {
      throw new BadRequestException('参数校验失败', errors.toString());
    }
    return dtoInstance;
  },
);

2. 控制器中替换原有@Body装饰器

// tokens.controllers.ts
@Post()
async create(@SnakeToCamelBody(CreateTokenDto) createTokenDto: CreateTokenDto) {
  return await this.tokensService.create(createTokenDto);
}

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