NestJS 8.0.6中POST请求嵌套请求体映射异常（嵌套字段为null）的解决方法

这个问题的核心原因是：NestJS默认不会自动把请求体的普通JSON对象转换为你定义的TypeScript类实例，TypeScript的类型标注只是编译时的语法提示，运行时没有元数据来指导嵌套对象的映射。要解决这个问题，我们需要借助class-transformer和class-validator两个工具包，配合NestJS的ValidationPipe来实现正确的请求体转换。

步骤1：安装依赖包 #

首先需要安装处理DTO转换和验证的必要依赖：

npm install class-validator class-transformer

步骤2：修改DTO类，添加转换装饰器 #

给你的每个类添加@Expose（确保属性被保留）和@Type（指定嵌套类类型）装饰器，让class-transformer知道如何处理嵌套对象：

import { Expose, Type } from 'class-transformer';
// 可选：添加验证装饰器，增强请求体校验
import { IsString } from 'class-validator';

export class Geo {
  @Expose()
  @IsString()
  lat: string;

  @Expose()
  @IsString()
  long: string;
}

export class Address {
  @Expose()
  @IsString()
  street: string;

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

  @Expose()
  @Type(() => Geo) // 告诉转换器这是Geo类的实例
  geo: Geo;
}

export class PayloadModel {
  @Expose()
  @IsString()
  name: string;

  @Expose()
  @Type(() => Address) // 告诉转换器这是Address类的实例
  address: Address;
}

步骤3：启用ValidationPipe并开启转换功能 #

你有两种方式启用管道，推荐全局启用（在main.ts中）：

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

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  // 全局启用验证管道，开启转换功能
  app.useGlobalPipes(new ValidationPipe({
    transform: true, // 关键：把普通JSON对象转换为DTO类实例
    whitelist: true, // 可选：自动移除DTO中未定义的字段
  }));
  await app.listen(3000);
}
bootstrap();

如果只需要在单个控制器方法上启用，也可以这样写：

import { Controller, Post, Body, UsePipes, ValidationPipe } from '@nestjs/common';
import { PayloadModel } from './payload.model';

@Controller('cont')
export class MyController{
  @Post('/readme')
  @UsePipes(new ValidationPipe({ transform: true }))
  async readPayload(@Body() body:PayloadModel){
    console.log(body); // 现在嵌套字段（street、lat等）会正确映射
  }
}

原理说明 #

• @Type()装饰器：告诉class-transformer如何将嵌套的JSON对象转换为对应的类实例，没有它的话，嵌套对象会被当作普通的JavaScript对象，无法关联到你定义的类。
• transform: true：开启后，NestJS的ValidationPipe会自动调用class-transformer，把请求体的plain object转换为你指定的DTO类实例，这样嵌套字段就能正确赋值了。

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