You need to enable JavaScript to run this app. Mongoose Schema虚拟属性为何查询时始终返回undefined?
优惠活动
大模型
产品
解决方案
定价
更多

Mongoose Schema虚拟属性为何查询时始终返回undefined?

问题描述

尝试通过Mongoose Schema的虚拟函数实现自定义标识字段,数据库托管在mongodb atlas上,已经删除整个集合并重新创建数据,问题依旧存在。确认查询的用户ID真实有效,但打印出的status虚拟属性始终为undefined。

复现代码

用户Schema定义

const mongoose = require('mongoose')
const UserSchema = new mongoose.Schema({
  name: String,
  email: String
}, {toObject: {virtuals: true, getters: true}})

UserSchema.virtual('status').get(() => {
   return this.name
})

const User = mongoose.model('User', UserSchema)

module.exports = {
    User,
    UserSchema
}

服务端入口逻辑(app.js)

const mongoose = require("mongoose");
const express = require("express");
const {User} = require("./models/User")
const app = express();

app.use(express.urlencoded({extended: true}));
app.use(express.json());

mongoose.connect(process.env.DB_URL, {
    useNewUrlParser: true,
    useUnifiedTopology: true
});

User.findById("600ae8001931ad49eae40c03", (err, doc) => {
    console.log(doc.status)
})

const port = process.env.PORT || 5000;

app.listen(port, () => {
    console.log(`server at http://localhost:${port}`);
});

问题定位及修复

代码存在两处明确问题,和MongoDB Atlas的托管环境、是否重建集合没有关联:

  • 虚拟字段getter的this指向错误
    定义status虚拟字段的getter时使用了箭头函数。箭头函数的this在定义阶段就会绑定到外层的模块全局作用域,不会指向Mongoose生成的文档实例,自然无法通过this.name取到文档上的字段值,最终虚拟属性返回undefined。
    把箭头函数替换为普通函数即可修正指向:
    UserSchema.virtual('status').get(function() {
      return this.name
    })
    
  • 遗漏JSON序列化的虚拟字段配置
    当前Schema配置只开启了toObject场景下的虚拟字段输出,但实际开发中如果要把查询到的文档通过接口返回、或者调用文档的toJSON()方法,Mongoose默认不会把虚拟字段纳入序列化结果。需要在Schema的配置项里补上toJSON的对应开启规则,避免后续输出接口时虚拟字段丢失:
    const UserSchema = new mongoose.Schema({
      name: String,
      email: String
    }, {
      toObject: {virtuals: true, getters: true},
      // 新增这段配置
      toJSON: {virtuals: true, getters: true}
    })
    

如果修改后仍有异常,可以在getter内部打印this确认指向:输出为Mongoose Document实例时即为正确状态。

内容的提问来源于stack exchange,提问作者kannavkm

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.07 11:06:00