如何使用Mongoose按文档_id统计contact数组中isActive=Y的子文档数

假设你的集合对应的Mongoose模型为YourModel，可根据实际场景选择以下两种方式实现计数：

方案1：应用层简单过滤（适合新手快速上手） #

如果文档体积不大、仅需单次查询该文档的统计值，可直接查出完整文档后，在Node.js应用层完成数组过滤计数，代码逻辑简单易理解：

• 第一步：根据指定_id精准查询目标文档

// lean()方法可直接返回普通JS对象，无需Mongoose文档实例的额外开销
// Mongoose的findById方法会自动将传入的字符串_id转换为ObjectId类型，无需手动处理
const targetDoc = await YourModel.findById('601ad0227b25254647823713').lean();

• 第二步：过滤contact数组中isActive为Y的子文档，计算长度即为统计值

const activeContactCount = targetDoc.contact.filter(contact => contact.isActive === 'Y').length;

• 该方式的优势是语法简单，无需理解MongoDB聚合管道逻辑，适合开发初期快速实现功能。

方案2：数据库层聚合统计（性能更优，适合大数据量场景） #

如果文档体积大、contact数组长度较长，可直接在MongoDB数据库层完成计数，无需将完整文档拉取到应用层，减少网络传输与内存开销。

推荐写法（最优性能） #

通过$filter直接在数组层过滤、$size计算符合条件的元素数量，无需拆分全数组：

// 从mongoose导入ObjectId处理方法
const { ObjectId } = require('mongoose');

const result = await YourModel.aggregate([
  // 1. 精准匹配目标文档，注意聚合管道需手动将字符串_id转为ObjectId类型
  { $match: { _id: ObjectId('601ad0227b25254647823713') } },
  {
    $project: {
      // 直接统计符合条件的子文档数量
      activeContactCount: {
        $size: {
          $filter: {
            input: "$contact",
            as: "contactItem",
            // 过滤规则：仅保留isActive值为Y的子文档
            cond: { $eq: ["$$contactItem.isActive", "Y"] }
          }
        }
      }
    }
  }
]);

// 取统计值，固定返回格式，无符合条件的条目时计数为0
const activeContactCount = result[0]?.activeContactCount || 0;

• 注意事项：
  • 聚合管道不会自动帮你把字符串格式的_id转换为MongoDB原生的ObjectId类型，必须手动转换才能匹配到正确文档
  • 该写法就算目标文档下没有符合条件的子文档，返回的计数也会为0，无需额外做空值兜底

基础聚合写法（逻辑更易理解） #

通过拆分数组逐行匹配的方式实现统计，适合理解聚合管道基础逻辑：

const result = await YourModel.aggregate([
  { $match: { _id: ObjectId('601ad0227b25254647823713') } },
  // 将contact数组拆分为独立文档行
  { $unwind: "$contact" },
  // 逐行匹配isActive为Y的条目
  { $match: { "contact.isActive": "Y" } },
  // 统计符合条件的条目总数
  { $count: "activeContactCount" }
]);

const activeContactCount = result[0]?.activeContactCount || 0;

这种写法性能略低于带$filter的写法，因为需要拆分全量数组后再逐行过滤，适合理解聚合原理时使用。

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