如何使用class-validator校验普通JavaScript对象？

针对你在DTO中需要校验任意JSON对象属性的场景，完全不需要自定义校验器，class-validator提供的内置装饰器就能满足需求，以下是几种实用方案：

基础校验：确保是普通对象 #

直接使用@IsObject()装饰器，它会校验值是标准的JavaScript对象（排除null、数组、字符串、函数等类型），完全匹配你需要的"任意JSON数据"的基础要求。同时建议把any换成Record<string, any>，既保留类型灵活性，又比any更具可读性：

import { IsBoolean, IsString, IsObject } from 'class-validator';

export class YourDto {
  @IsBoolean()
  someBool: boolean;

  @IsString()
  someStr: string;

  @IsObject()
  someObject: Record<string, any>;
}

如果需要确保对象非空（至少包含一个键值对），可以额外加上@IsNotEmptyObject()装饰器。

可选对象场景：允许字段为空或不传 #

如果someObject是可选字段，允许前端不传或者传入空对象，可以结合@IsOptional()使用：

import { IsBoolean, IsString, IsObject, IsOptional } from 'class-validator';

export class YourDto {
  @IsBoolean()
  someBool: boolean;

  @IsString()
  someStr: string;

  @IsOptional()
  @IsObject()
  someObject?: Record<string, any>;
}

兼容JSON字符串转对象的场景 #

如果前端可能传入JSON格式的字符串（而非直接传对象），可以用@Transform()先尝试解析字符串为对象，再用@IsObject()校验：

import { IsBoolean, IsString, IsObject, Transform } from 'class-validator';

export class YourDto {
  @IsBoolean()
  someBool: boolean;

  @IsString()
  someStr: string;

  @Transform(({ value }) => {
    if (typeof value === 'string') {
      try {
        return JSON.parse(value);
      } catch (e) {
        // 解析失败保留原值，后续@IsObject()会触发校验错误
        return value;
      }
    }
    return value;
  })
  @IsObject()
  someObject: Record<string, any>;
}

总结 #

你的场景完全不需要自定义校验器，class-validator的内置装饰器已经覆盖了所有需求，这是最简洁高效的方案。只有当你需要对对象的结构做动态规则校验（比如根据其他字段的值决定校验逻辑）时，才需要考虑自定义校验器。

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