NestJS/Express场景下如何实现请求DTO Body字段大小写不敏感匹配

以下方案适用于NestJS + class-validator + class-transformer 技术栈，可保留原有驼峰命名写法，兼容不同大小写格式的请求字段：

方案1：全局生效（推荐） #

自定义全局验证管道，对所有POST请求的Body自动做大小写匹配映射，无需修改单个DTO代码：

1. 首先实现自定义管道：

import { ValidationPipe, ArgumentMetadata } from '@nestjs/common';

export class CaseInsensitiveValidationPipe extends ValidationPipe {
  async transform(value: any, metadata: ArgumentMetadata) {
    const { metatype, type } = metadata;
    // 仅处理Body类型的DTO校验
    if (type !== 'body' || !metatype || !this.isDto(metatype)) {
      return value;
    }
    // 生成DTO属性的小写映射表
    const dtoInstance = new metatype();
    const dtoProps = Object.getOwnPropertyNames(dtoInstance);
    const lowerPropMap = new Map(
      dtoProps.map(prop => [prop.toLowerCase(), prop])
    );
    // 转换请求体字段到驼峰属性
    const transformedBody = {};
    Object.entries(value).forEach(([key, val]) => {
      const lowerKey = key.toLowerCase();
      const targetProp = lowerPropMap.get(lowerKey);
      transformedBody[targetProp || key] = val;
    });
    // 走原有验证逻辑
    return super.transform(transformedBody, metadata);
  }

  private isDto(metatype: Function): boolean {
    const builtInTypes = ['String', 'Boolean', 'Number', 'Array', 'Object'];
    return !builtInTypes.includes(metatype.name);
  }
}

2. 替换项目原有全局管道：
   在main.ts中修改全局管道配置：

import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';
import { CaseInsensitiveValidationPipe } from './case-insensitive.pipe';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  app.useGlobalPipes(new CaseInsensitiveValidationPipe({
    whitelist: true, // 自动过滤未在DTO定义的字段，可选
    transform: true,
    forbidNonWhitelisted: false,
  }));
  await app.listen(3000);
}
bootstrap();

方案2：单字段自定义装饰器（粒度可控） #

如果不需要全局生效，仅给指定字段做大小写兼容，可以自定义装饰器修饰DTO属性：

1. 定义自定义装饰器：

import { Transform } from 'class-transformer';

export const CaseInsensitiveMatch = () => {
  return Transform(({ obj, key }) => {
    const targetLowerKey = key.toLowerCase();
    const matchKey = Object.keys(obj).find(
      k => k.toLowerCase() === targetLowerKey
    );
    return matchKey ? obj[matchKey] : undefined;
  });
};

2. 在DTO中使用：

import { IsOptional, IsString } from 'class-validator';
import { CaseInsensitiveMatch } from './case-insensitive.decorator';

export class ExampleDto {
  @CaseInsensitiveMatch()
  @IsOptional()
  @IsString()
  dateOfBirth?: string;
}

两种方案都可以兼容dateofbirth、dateOfBirth、DATEOFBIRTH三种格式的入参，最终都会自动映射到DTO的驼峰属性dateOfBirth上，原有业务代码的驼峰写法无需调整。

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