Mongoose虚拟属性统计文档数量报错，返回空值求助

核心问题点 #

1. 虚拟属性是针对单个文档实例设计的，用来统计集合级别的总数并不合适，会导致重复查询、效率低下。
2. 代码中使用了未定义的AppUser，实际模型应为User。
3. 异步虚拟属性的getter未正确返回Promise，导致返回空值；同时重复调用查询对象触发了Mongoose的"Query was already executed"错误。

推荐解决方案：使用静态方法（集合级操作更合理） #

将统计逻辑封装为模型的静态方法，直接在业务代码中调用：

const mongoose = require('mongoose');

const appUserSchema = new mongoose.Schema({ 
  FullName: {
    type: String,
    required: [true, 'Full name is required'],             
  },   
  Username: { 
    type: String,
    lowercase: true, 
  },
  UserType: { 
    type: String,
    enum: ['Local', 'Foreign'],
    default: 'Local'
  }
}, {
  toJSON: {
    virtuals: true, 
    getters: true // 修正原代码的单复数错误
  },
  toObject: {
    virtuals: true
  }
});

// 静态方法：统计总用户数
appUserSchema.statics.getTotalUsers = async function() {
  return this.countDocuments({});
};

// 静态方法：统计Local类型用户数
appUserSchema.statics.getLocalUsersCount = async function() {
  return this.countDocuments({ UserType: 'Local' });
};

const User = mongoose.model('User', appUserSchema);

module.exports = { mongoose, User };

业务代码中调用示例

const { User } = require('./your-model-file-path');

async function fetchUserStats() {
  try {
    const totalUsers = await User.getTotalUsers();
    const localUsers = await User.getLocalUsersCount();
    console.log(`总用户数：${totalUsers}，本地用户数：${localUsers}`);
    return { totalUsers, localUsers };
  } catch (err) {
    console.error('统计失败：', err);
  }
}

// 执行统计
fetchUserStats();

若坚持使用虚拟属性（不推荐，效率低） #

如果一定要用虚拟属性实现，需修正异步逻辑与模型引用问题：

// 修正虚拟属性的异步写法
appUserSchema.virtual('TotalAppUsers').get(async function() {
  // 使用this.constructor获取当前模型，避免未定义的AppUser
  const total = await this.constructor.countDocuments({});
  console.log('Total users is ' + total);
  return total;
});

appUserSchema.virtual('TotalLocalUsers').get(async function() {
  const total = await this.constructor.countDocuments({ UserType: 'Local' });
  console.log('Total local user is ' + total);
  return total;
});

注意：这种方式下，每个文档实例调用虚拟属性都会触发一次数据库查询，大量使用会严重影响性能，仅适合单个实例的场景。

错误原因说明 #

1. 未定义的AppUser：原代码中直接使用AppUser.countDocuments，但实际模型名为User，应通过this.constructor（实例上下文）或直接使用User（定义模型后）来调用。
2. 异步回调未返回Promise：async函数需返回Promise才能获取异步结果，原代码中的回调函数无法被async捕获，导致虚拟属性返回空值。
3. 重复执行查询：Mongoose的查询对象不可重复执行，改用async/await调用countDocuments会每次创建新的查询对象，避免该错误。

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