NestJS PATCH请求未传可选字段时如何将MySQL对应字段置为null

class-validator的@IsOptional()装饰器默认仅在字段完全不存在于请求体时跳过校验，配合@nestjs/mapped-types的PartialType()生成的更新DTO，默认会将未出现在请求体中的字段判定为undefined，ORM更新逻辑通常默认会跳过undefined字段不做处理，因此无法触发字段置空操作。
当前逻辑无法区分两种核心场景：

• 请求完全没传目标字段：预期保持数据库原值
• 请求显式传了目标字段值为null：预期将数据库字段更新为null

1. 调整DTO校验规则，允许字段接收null值 #

修改CreateItemProtoDto，给@IsOptional()开启nullable配置，同时给字段类型补充null类型支持，允许显式传入null值：

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

export class CreateItemProtoDto {
  @IsNumber()
  @IsOptional({ nullable: true })
  readonly refined_vnum?: number | null;

  @IsNumber()
  @IsOptional({ nullable: true })
  readonly refine_set?: number | null;
}

UpdateItemProtoDto无需额外修改，继承PartialType的逻辑会自动继承上述校验规则。

2. 调整服务层更新逻辑，区分undefined和null #

更新时不要直接把整个DTO对象传入ORM更新方法，手动过滤值为undefined的字段（即请求完全没传的字段），保留值为null的字段正常传入更新：

// 服务层更新逻辑示例（以TypeORM为例）
async update(id: number, updateDto: UpdateItemProtoDto) {
  // 构造更新参数，仅传入请求中明确携带的字段（包括值为null的字段）
  const updateData: Partial<ItemProtoEntity> = {};
  if (updateDto.refined_vnum !== undefined) {
    updateData.refined_vnum = updateDto.refined_vnum;
  }
  if (updateDto.refine_set !== undefined) {
    updateData.refine_set = updateDto.refine_set;
  }
  // 其余业务字段按相同逻辑处理

  return this.itemProtoRepository.update(id, updateData);
}

3. 遵循请求传参规范 #

如果需要将字段置为null，必须在PATCH请求体中显式传入对应字段值为null：

{
  "refined_vnum": null,
  "refine_set": null
}

如果请求体中完全不携带这两个字段，对应字段会保持数据库原有值不变，符合PATCH方法的语义要求。

常见配置冲突排查 #

如果配置后仍然无法正常置空，检查全局ValidationPipe配置：

• 不要开启skipNullProperties相关配置
• 检查class-transformer配置，不要配置自动将null转换为undefined的规则

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