NestJS嵌套对象验证异常：合法对象仍触发校验错误

问题场景 #

我编写了用于网络验证的嵌套DTO类，代码如下：

import { Transform } from 'class-transformer';
import { IsIP, IsNotEmpty, IsOptional, IsString, ValidateNested } from 'class-validator';

export class IpAddressRequest {
  @IsNotEmpty()
  @IsString()
  @IsIP()
  public address?: string;

  @IsOptional()
  public netmask?: string;

  constructor(address?: string, netmask?: string) {
    this.address = address;
    this.netmask = netmask;
  }
}

export class CreateRouteRequest {
  @IsNotEmpty()
  @IsString()
  @IsIP()
  gateway: string;

  @IsOptional()
  @Transform(({ value }) => {
    return new IpAddressRequest(value.destination?.address, value.destination?.netmask);
  })
  @ValidateNested({ each: true })
  destination?: IpAddressRequest;
}

预期传入如下请求负载时验证通过：

{
  "gateway": "192.168.1.1",
  "destination": {
    "address": "10.10.10.20"
  }
}

但实际收到destination.address的校验错误：

{
  "statusCode": 400,
  "message": [
    "destination.address must be an ip address",
    "destination.address must be a string",
    "destination.address should not be empty"
  ],
  "error": "Bad Request"
}

错误原因 #

1. Transform逻辑错误：CreateRouteRequest的destination字段中，Transform装饰器错误尝试获取value.destination?.address，但实际value就是请求负载里的destination对象本身，value.destination为undefined，导致实例化IpAddressRequest时address参数为空，触发校验失败。
2. 缺少类型声明：使用ValidateNested时必须配合@Type()装饰器指定嵌套对象类型，否则class-validator无法识别DTO结构，校验逻辑不生效。
3. 可选字段校验冲突：IpAddressRequest的address标记为可选但加了@IsNotEmpty()，意味着只要传入destination，address就必须非空，这个逻辑本身没问题，但前提是Transform能正确传递值。

修复方案 #

1. 修正Transform逻辑，直接从value中提取address和netmask实例化IpAddressRequest；
2. 添加@Type(() => IpAddressRequest)装饰器，明确嵌套对象的类型；
3. （可选）若需允许destination存在但address为空，可将@IsNotEmpty()改为@IsNotEmpty({ always: false })，但按你的预期场景，保持原校验即可。

修改后的代码 #

import { Transform, Type } from 'class-transformer';
import { IsIP, IsNotEmpty, IsOptional, IsString, ValidateNested } from 'class-validator';

export class IpAddressRequest {
  @IsNotEmpty()
  @IsString()
  @IsIP()
  public address?: string;

  @IsOptional()
  public netmask?: string;

  constructor(address?: string, netmask?: string) {
    this.address = address;
    this.netmask = netmask;
  }
}

export class CreateRouteRequest {
  @IsNotEmpty()
  @IsString()
  @IsIP()
  gateway: string;

  @IsOptional()
  @Type(() => IpAddressRequest) // 指定嵌套对象类型
  @Transform(({ value }) => {
    return new IpAddressRequest(value.address, value.netmask);
  })
  @ValidateNested({ each: true })
  destination?: IpAddressRequest;
}

如果不需要手动实例化对象，class-transformer会根据@Type装饰器自动转换，可进一步简化代码：

export class CreateRouteRequest {
  @IsNotEmpty()
  @IsString()
  @IsIP()
  gateway: string;

  @IsOptional()
  @Type(() => IpAddressRequest)
  @ValidateNested({ each: true })
  destination?: IpAddressRequest;
}

这样class-transformer会自动将请求中的destination对象转为IpAddressRequest实例，配合ValidateNested即可正常完成校验。

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