mongoose-paginate无法渲染Mongoose模型虚拟字段，寻求解决方案

我之前也踩过这个坑，核心原因在于mongoose-paginate的lean模式默认行为：当启用lean时，返回的是原始MongoDB文档对象（普通JS对象），而非Mongoose的Document实例，这时候虚拟字段的getter不会被触发。下面是几个可行的解决方案，按推荐优先级排序：

方案1：禁用lean模式（最简单直接） #

如果你的性能要求不是极端苛刻，直接在调用paginate时设置lean: false，同时确保Schema已经配置了包含虚拟字段的转换规则：

步骤1：Schema中配置虚拟字段及转换规则 #

const mongoose = require('mongoose');
const mongoosePaginate = require('mongoose-paginate');

const userSchema = new mongoose.Schema({
  firstName: String,
  lastName: String
});

// 定义虚拟字段
userSchema.virtual('fullName').get(function() {
  return `${this.firstName} ${this.lastName}`;
});

// 确保虚拟字段在toJSON/toObject转换时被包含
userSchema.set('toJSON', { virtuals: true });
userSchema.set('toObject', { virtuals: true });

// 挂载分页插件
userSchema.plugin(mongoosePaginate);

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

步骤2：调用paginate时禁用lean #

User.paginate({}, { page: 1, limit: 10, lean: false })
  .then(paginationResult => {
    // paginationResult.docs中的每个文档都会包含fullName虚拟字段
    console.log(paginationResult.docs);
  })
  .catch(err => console.error(err));

方案2：启用lean模式时手动注入虚拟字段 #

如果因为性能原因必须使用lean，可以在分页结果返回后，手动遍历文档并添加虚拟字段：

User.paginate({}, { page: 1, limit: 10, lean: true })
  .then(paginationResult => {
    // 遍历docs，手动计算并添加虚拟字段
    paginationResult.docs = paginationResult.docs.map(doc => {
      doc.fullName = `${doc.firstName} ${doc.lastName}`;
      return doc;
    });
    console.log(paginationResult.docs);
  })
  .catch(err => console.error(err));

或者更优雅地用Mongoose的hydrate方法将普通对象转为Document实例，再导出带虚拟字段的JSON：

User.paginate({}, { page: 1, limit: 10, lean: true })
  .then(paginationResult => {
    paginationResult.docs = paginationResult.docs.map(doc => 
      User.hydrate(doc).toJSON()
    );
    console.log(paginationResult.docs);
  })
  .catch(err => console.error(err));

方案3：升级到维护中的分页插件（可选） #

你当前使用的edwardhotchkiss/mongoose-paginate已经很久没有维护了，建议考虑切换到mongoose-paginate-v2（它是原项目的活跃分支），这个版本对虚拟字段的支持更完善，默认情况下在合适的配置下就能自动渲染虚拟字段，无需额外手动处理。

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