如何用NestJS Validation Pipe和class-transformer解析短横线式查询参数

这个需求完全可行，不需要改用@Query()装饰器手动处理，核心是通过class-transformer的装饰器实现字段名映射，配合已配置的全局验证管道就能完成自动转换和验证。

实现步骤 #

1. 在DTO中使用@Expose指定原始字段名
   利用@Expose装饰器的name参数，将请求中的kebab-case字段与DTO的驼峰属性绑定，同时保留class-validator的验证规则：

   import { IsString } from 'class-validator';
   import { Expose } from 'class-transformer';
   
   export class MyValidationDto {
     @Expose({ name: 'param-one' })
     @IsString()
     paramOne: string;
   
     @Expose({ name: 'param-two' })
     @IsString()
     paramTwo: string;
   }
   

2. 确保全局验证管道开启transform选项
   你的全局ValidationPipe必须配置transform: true，否则class-transformer的转换逻辑不会触发。检查app.module.ts中的配置：

   import { Module } from '@nestjs/common';
   import { APP_PIPE } from '@nestjs/core';
   import { ValidationPipe } from '@nestjs/common';
   
   @Module({
     providers: [
       {
         provide: APP_PIPE,
         useValue: new ValidationPipe({
           transform: true, // 关键配置，开启自动转换
           whitelist: true, // 可选，过滤DTO未定义的字段
           forbidNonWhitelisted: true, // 可选，拒绝包含未定义字段的请求
         }),
       },
     ],
   })
   export class AppModule {}
   

3. 控制器中直接使用DTO接收查询参数
   控制器里正常用@Query()注入DTO即可，转换和验证会自动完成：

   import { Controller, Get, Query } from '@nestjs/common';
   import { MyValidationDto } from './my-validation.dto';
   
   @Controller('path')
   export class MyController {
     @Get()
     getResource(@Query() query: MyValidationDto) {
       // 此时query.paramOne和query.paramTwo已经是请求中param-one、param-two的值
       return { received: query };
     }
   }
   

替代方案（不推荐） #

如果一定要用@Query()装饰器手动处理，可以单独对每个参数做映射，但这种方式代码冗余，不符合NestJS的DTO规范化思路：

@Get()
getResource(
  @Query('param-one') paramOne: string,
  @Query('param-two') paramTwo: string,
) {
  // 手动转换后再验证，不如DTO方式高效
}

内容的提问来源于stack exchange，提问作者Le Thanh An