NestJs中前端camelCase payload转后端snake_case DTO的最优方案

核心推荐：class-transformer全局配置 + 自动转换 #

无需在每个字段手动加装饰器，全局配置一次即可实现批量转换，是最简洁高效的方案。

步骤1：配置全局转换规则 #

在NestJS主模块（如app.module.ts）中，给ValidationPipe开启自动转换，并设置驼峰/下划线互转规则：

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, // 开启请求体到DTO的自动转换
        transformOptions: {
          enableImplicitConversion: true, // 自动完成基础类型转换（如字符串转数字）
          strategy: 'snake_case', // 自动将请求体的camelCase映射为DTO的snake_case
        },
        // 可选：如果需要响应体自动把snake_case转回camelCase，追加以下配置
        // classToPlain: (obj) => classToPlain(obj, { strategy: 'camelCase' }),
      }),
    },
  ],
})
export class AppModule {}

步骤2：编写snake_case格式的DTO #

直接以下划线命名字段，配合class-validator的校验装饰器即可，无需额外配置：

import { IsNotEmpty, IsNumber } from 'class-validator';

export class CreateCompanyDto {
  @IsNotEmpty()
  company_name: string;

  @IsNotEmpty()
  @IsNumber()
  employee_count: number;
}

步骤3：控制器接收请求 #

控制器中直接注入DTO，NestJS会自动将前端传入的employeeCount转换为DTO中的employee_count：

import { Controller, Post, Body } from '@nestjs/common';
import { CreateCompanyDto } from './dto/create-company.dto';

@Controller('companies')
export class CompaniesController {
  @Post()
  create(@Body() createCompanyDto: CreateCompanyDto) {
    console.log(createCompanyDto.employee_count); // 前端传的employeeCount已自动转换
    return createCompanyDto;
  }
}

你之前的方案失效原因解析 #

@Expose使用错误 #

你之前的@Expose({name: "employeeCount"})逻辑搞反了：该配置是将DTO的employee_count序列化为响应体的employeeCount，而非将请求体的employeeCount转换为DTO的employee_count。若要单独配置字段，需配合@Transform且指定toClassOnly，但这种方式远不如全局配置简洁。

getter返回undefined的问题 #

class-transformer的默认转换逻辑仅处理类的实例属性，getter作为访问器属性不会被自动赋值，因此会返回undefined。这种方式既繁琐又易出错，不推荐使用。

额外优化：响应体自动转回camelCase #

如果需要后端返回的响应体自动将snake_case转回camelCase给前端，只需在transformOptions中追加classToPlain配置：

transformOptions: {
  enableImplicitConversion: true,
  strategy: 'snake_case', // 请求体转DTO规则
  classToPlain: (obj) => classToPlain(obj, { strategy: 'camelCase' }), // 响应体转前端格式规则
},

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