NestJS/Mongoose序列化无法排除plain输出属性该如何解决？

为什么直接返回Mongoose查询结果序列化不生效 #

ClassSerializerInterceptor底层依赖class-transformer的序列化能力，它的规则生效有个前提：返回的对象必须是你定义的带装饰器的类的实例。

• 不加.lean()的findOne()返回的是Mongoose内置的Document实例，不是你写的User类的实例，身上没有你加的@Exclude等装饰器的元数据，所以序列化规则不生效，还会返回很多Mongoose内置的$__、$locals等属性。
• 加.lean()返回的是纯JavaScript普通对象，连类实例都不是，更不会关联到你给User类定义的序列化规则，所以也不会过滤字段。

你手动new User(...)之后得到的是你自己定义的User类的实例，身上带有完整的装饰器元数据，所以序列化会按照预期生效。你没有遗漏任何配置，这个是Nest序列化拦截器的固有设计。

你不需要每次查询都手动遍历实例化，有几种更优雅的统一处理方案：

方案1：自定义序列化拦截器自动转换 #

继承官方的ClassSerializerInterceptor，在序列化前自动把Mongoose的返回结果转换成对应类的实例：

import { ClassSerializerInterceptor, ExecutionContext, Injectable } from '@nestjs/common';
import { plainToInstance } from 'class-transformer';
import * as mongoose from 'mongoose';

@Injectable()
export class MongooseSerializerInterceptor extends ClassSerializerInterceptor {
  serialize(response: any, context: ExecutionContext) {
    const returnType = this.reflector.get('design:returntype', context.getHandler());
    if (!returnType || !response) return super.serialize(response, context);

    // 处理数组和单条数据两种场景
    const transform = (item: any) => {
      const plain = item instanceof mongoose.Document ? item.toObject() : item;
      return plainToInstance(returnType, plain);
    };

    const transformed = Array.isArray(response) ? response.map(transform) : transform(response);
    return super.serialize(transformed, context);
  }
}

之后控制器直接用这个自定义拦截器代替默认的ClassSerializerInterceptor即可，不需要手动做实例转换。

方案2：在Schema层面配置全局转换规则 #

直接给Mongoose Schema配置toJSON转换逻辑，不需要依赖class-transformer和序列化拦截器就能实现字段过滤：

export const UserSchema = SchemaFactory.createForClass(User);

UserSchema.set('toJSON', {
  transform: (_, ret) => {
    // 自定义返回字段
    ret.id = ret._id.toString();
    delete ret._id;
    delete ret.password;
    delete ret.__v;
    return ret;
  }
});

如果使用.lean()查询，需要加上{ transform: true }选项才会触发转换：

this.userModel.findOne().lean({ transform: true })

方案3：Repository层统一封装 #

把所有数据库查询逻辑封装到Repository层，在Repository内部统一做实例转换，上层Service和Controller拿到的都是已经转换好的类实例，不需要每个接口单独处理。

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