Mongoose自定义实例方法调用异常：aggregate查询结果无法调用方法

问题根源 #

你碰到的问题本质是：Mongoose的aggregate()方法返回的是原生JavaScript对象，而非Mongoose封装的Document实例。只有find()、findOne()这类查询方法返回的结果，才会绑定Schema中定义的实例方法——这就是为什么findOne()返回的order能正常调用updateProductionStatus()，而aggregate()返回的orders[0]不行。

解决方案 #

下面提供几种不同场景下的解决办法，你可以根据业务需求选择：

1. 将聚合结果转换为Document实例（推荐，适合需要修改并保存的场景）

使用Mongoose模型的hydrate()方法，把聚合返回的普通对象转换成带有实例方法的Document：

let orders = await Order.aggregate(/* 你的聚合逻辑 */);
// 转换第一个结果为Document实例
let orderDoc = Order.hydrate(orders[0]);
// 现在可以正常调用实例方法了
orderDoc.updateProductionStatus();
// 别忘了保存修改到数据库
await orderDoc.save();

2. 改用静态方法（适合仅做数据处理，不需要直接保存的场景）

如果你的方法只是对数据做计算或修改，不需要直接操作数据库，可以把它定义为Schema的静态方法，直接接收普通对象作为参数：

修改Schema定义：

// 替换原来的实例方法为静态方法
OrderSchema.statics.updateProductionStatus = function(orderObj) {
  orderObj.percentage = "88%";
  return orderObj;
};

控制器中调用：

let orders = await Order.aggregate(/* 你的聚合逻辑 */);
let updatedOrder = Order.updateProductionStatus(orders[0]);
// 如果需要保存修改，手动执行更新操作
await Order.updateOne(
  { _id: updatedOrder._id },
  { percentage: updatedOrder.percentage }
);

3. 替换聚合为普通查询（如果业务逻辑允许）

如果你的聚合逻辑比较简单（比如只是过滤、排序），可以直接用find()替代aggregate()，这样返回的就是天然的Document实例，直接调用方法即可：

// 用find替代aggregate（示例，根据你的实际逻辑调整）
let orders = await Order.find(/* 查询条件 */).sort(/* 排序规则 */);
orders[0].updateProductionStatus();
await orders[0].save();

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