使用TypeScript扩展运算符时Prisma不识别可选字段的原因

核心原因分析 #

这个问题是TypeScript对象扩展行为、Prisma运行时字段处理逻辑以及NestJS DTO序列化规则三者共同作用的结果：

1. NestJS DTO的字段移除规则：使用class-validator的@IsOptional()时，默认的class-transformer会把客户端未传入的可选字段从DTO实例中直接移除，而非保留为undefined。也就是说，当用户没传surfaceArea时，roomDetails对象里根本没有这个键。
2. 扩展运算符的复制逻辑：...roomDetails只会复制对象中实际存在的键，不存在的键不会出现在扩展后的对象里。
3. Prisma的字段处理差异：
   • 如果data里没有对应字段，Prisma会默认不处理该字段（或使用数据库默认值）；
   • 如果显式传入字段且值为undefined，Prisma会把它转为null（前提是schema中该字段允许为null）。

你显式写surfaceArea: roomDetails.surfaceArea时，哪怕roomDetails里没有这个键，表达式结果是undefined，相当于给Prisma传入了surfaceArea: undefined，触发了转null的逻辑，所以功能正常。

底层机制拆解 #

TypeScript类型层面 #

你的CreateRoomBodyDto中surfaceArea是可选属性（?: number），所以Omit<CreateRoomBodyDto, 'facilities'>允许该字段不存在或为undefined。但Prisma生成的RoomCreateInput类型中，可选字段的类型是number | null | undefined：

• undefined代表“不传递该字段”；
• null代表“将字段设为null”。

扩展运算符的写法中，如果roomDetails没有surfaceArea键，TypeScript会判定你没传递这个字段，Prisma自然不会处理；而显式赋值时，哪怕值是undefined，TypeScript会认为你传递了字段（值为undefined），Prisma就会按规则转成null。

Prisma运行时逻辑 #

Prisma处理create的data参数时：

• 直接忽略不存在的字段；
• 对存在但值为undefined的可选字段，自动转为null（仅当schema中字段标记为nullable，即带?）。

这就是两种写法行为差异的核心。

优化方案 #

1. 调整class-transformer配置保留undefined #

在DTO类上添加@Exclude配置，让class-transformer保留未传入的可选字段为undefined：

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

@Exclude({ excludeExtraneousValues: false })
export class CreateRoomBodyDto {
  // ...其他字段
  @IsNumber()
  @IsOptional()
  surfaceArea?: number;
}

这样客户端没传surfaceArea时，roomDetails里会保留surfaceArea: undefined，扩展运算符就能把它带入Prisma的data中，触发转null的逻辑。

2. 显式转换undefined为null #

手动处理可选字段，确保Prisma能正确识别：

const room = await this.prismaClient.room.create({
  data: {
    ...roomDetails,
    surfaceArea: roomDetails.surfaceArea ?? null,
  },
});

这种方式不需要修改全局配置，适合局部场景。

3. 给Prisma字段设置默认null #

如果希望surfaceArea默认就是null，直接在schema中设置默认值：

model Room {
  id           Int          @id @default(autoincrement())
  name         String       @db.VarChar()
  roomType     String       @db.VarChar()
  propertyId   Int
  surfaceArea  Float?       @default(null)
  // ...其他字段
}

这样即使Prisma没收到该字段，也会自动写入null。

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