使用NestJS/Mongoose装饰器创建Mongo Schema时自定义联合类型字段的配置问题

你遇到的问题很典型——TypeScript的类型（比如你的Status联合类型）仅存在于编译阶段，运行时会被完全擦除，而Mongoose需要运行时可识别的类型信息来生成数据库Schema。下面给你两种可行的解决方案：

方案1：使用Mongoose混合类型（Mixed） #

Mongoose的Schema.Types.Mixed是专门处理多类型场景的内置类型，能接受任意合法值。你可以这样修改代码：

import { Schema, Prop, SchemaFactory } from '@nestjs/mongoose';
import { SchemaTypes } from 'mongoose';

export type Status = boolean | 'pending';

@Schema()
export class Constraint {
  @Prop() reason: string;
  // 用Mongoose内置的混合类型指定字段类型
  @Prop({ type: SchemaTypes.Mixed })
  status: Status;
  @Prop() time: number;
}

export const ConstraintSchema = SchemaFactory.createForClass(Constraint);

如果需要保证数据合法性，还可以给字段加上自定义验证器，确保status只能是boolean或'pending'：

@Prop({
  type: SchemaTypes.Mixed,
  validate: {
    validator: (value: unknown) => {
      return typeof value === 'boolean' || value === 'pending';
    },
    message: 'Status must be a boolean or "pending"',
  },
})
status: Status;

方案2：指定允许的类型数组 #

Mongoose支持在type参数中传入类型数组，表示字段可以是数组内的任意一种类型。结合自定义验证，能更精准地约束值的范围：

@Prop({
  // 明确字段可以是布尔或字符串类型
  type: [Boolean, String],
  validate: {
    validator: (value: unknown) => {
      return typeof value === 'boolean' || value === 'pending';
    },
    message: 'Status must be a boolean or "pending"',
  },
})
status: Status;

这种方式比混合类型更清晰，Mongoose会先校验值是否属于布尔/字符串类型，再通过验证器过滤掉不符合要求的字符串值。

为什么{ type: Status }不生效？ #

因为Status是TypeScript的类型别名，它只是编译阶段的类型约束，在运行时根本不存在对应的实体值。Mongoose需要的是运行时可识别的构造函数（比如Boolean、String）或内置Schema类型，直接传入TS类型自然会报错。

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