MongooseJS中正确比较ObjectId引用对象与关联实体的方法

你遇到的编译报错、直接等值判断返回false的问题，来自两个核心偏差：

• TypeScript 接口定义和Mongoose运行时实际返回值类型不匹配：你将_id标注为string、未填充的关联字段owner标注为PlanUser类型，但实际未调用populate时，owner字段存储的是ObjectId实例；就算是查询返回的完整PlanUser文档，其_id字段也是ObjectId实例，而非字符串。
• ObjectId是引用类型，两个值完全相同的ObjectId实例直接用==/===比较时，判断的是内存引用地址而非实际值，自然会返回false，和两个内容一致的普通对象直接做等值比较返回false的逻辑完全一致。

推荐实现方案 #

1. 用Mongoose原生equals()方法做Id比较（符合框架设计惯例） #

Mongoose的ObjectId原型上内置了equals()方法，专门用于做Id值的等值判断，不需要手动转换字符串，是官方推荐的标准写法，性能优于字符串转换：

planUserModel.findUser('abc123', (user: PlanUser) => {
    planUserModel.findPlan('def456', (plan: Plan ) => {
        // 未调用populate时，plan.owner本身就是ObjectId，直接和user._id比较即可
        const isOwner = plan.owner.equals(user._id); // 值匹配时返回true

        // 如果后续用populate('owner')把owner填充为完整用户对象，则比较两个文档的_id
        // const isOwner = plan.owner._id.equals(user._id);
    });
});

2. 修正TypeScript类型定义，消除编译错误 #

调整接口定义匹配Mongoose的实际返回类型，从根源解决类型不匹配的编译问题：

import { Types } from 'mongoose';

export interface PlanUser {
    _id: Types.ObjectId;
    name: string;
    email: string;
}

export interface Plan {
    _id: Types.ObjectId;
    name: string;
    // 联合类型适配两种场景：未populate时是ObjectId，populate后是完整PlanUser实体
    owner: Types.ObjectId | PlanUser;
}

3. 统一配置序列化规则，适配前端字符串Id需求 #

不需要在业务逻辑层强行把所有Id转成字符串来适配前端，只需要在Schema中配置全局的序列化转换规则，文档调用toJSON()/toObject()（比如res.json()返回响应时会自动调用）时，会自动把ObjectId转为字符串，前端完全感知不到后端存储层的实现细节：

// 公共序列化转换函数
const docTransform = (_doc: any, ret: any) => {
    ret._id = ret._id.toString();
    // 递归处理populate的关联字段Id
    if (ret.owner?._id) {
        ret.owner._id = ret.owner._id.toString();
    }
    // 清理不需要返回给前端的字段
    delete ret.__v;
    return ret;
};

// 在两个Schema中挂载配置
public static userSchema: Schema<PlanUser> = new Schema<PlanUser>({
    name: { type: String, required: true },
    email: { type: String, required: true },
}, { 
    autoCreate: false,
    toJSON: { transform: docTransform },
    toObject: { transform: docTransform }
});

public static planSchema: Schema<Plan> = new Schema<Plan>({
    name: { type: String, required: true },
    owner: { type: Schema.Types.ObjectId, ref: 'PlanUser' },
}, { 
    autoCreate: false,
    toJSON: { transform: docTransform },
    toObject: { transform: docTransform }
});

这套实现下，业务逻辑层始终操作原生Mongoose文档，用equals()做Id比较，没有冗余的类型转换代码；返回给前端的响应自动转成字符串Id，完全满足业务需求。

不推荐的写法 #

• 每次比较时手动调用toString()转换双方Id：代码冗余容易漏写，性能低于原生equals()方法
• 直接用==/===比较ObjectId实例：仅在两个变量指向同一个对象实例时返回true，值相同但实例不同时会返回false，容易引发隐蔽的逻辑bug
• 查询时统一用lean()+手动遍历转换所有Id为字符串：会丢失Mongoose文档的内置方法，增加不必要的遍历转换成本

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