MongoDB Aggregation如何使用$sum正确计算数组中整数的总和

在MongoDB的聚合操作中，$sum是非常常用的算术操作符，主要用于对数值进行求和计算。当文档中包含数组类型的字段，且需要计算该数组内所有整数的总和时，很多开发者会遇到结果不符合预期的情况，核心原因是对$sum的操作逻辑理解不到位。

$sum操作符基础用法

$sum可以在聚合管道的多个阶段使用，最常用的是在$group阶段做分组求和，或者在$project阶段做字段计算。$sum的基本语法是接收一个表达式，会对表达式返回的所有数值进行累加，如果表达式返回的是非数值类型，会被忽略或者转换为0，具体取决于MongoDB的版本处理逻辑。

普通字段求和示例

假设我们有一个存储用户订单的集合，每个文档包含用户ID和订单金额，现在需要计算每个用户的总订单金额，基础用法如下：

// 订单集合示例文档
// { "_id": 1, "userId": "u1", "amount": 100 }
// { "_id": 2, "userId": "u1", "amount": 200 }
// { "_id": 3, "userId": "u2": 150 }

// 聚合管道计算用户总金额
db.orders.aggregate([
  {
    $group: {
      _id: "$userId",
      totalAmount: { $sum: "$amount" }
    }
  }
])
// 输出结果：
// { "_id": "u1", "totalAmount": 300 }
// { "_id": "u2", "totalAmount": 150 }

计算数组中整数的总和

当求和的目标不是单个字段，而是文档中某个数组字段的所有元素时，直接使用$sum: "$arrayField"是无法得到正确结果的，因为$sum默认不会对数组进行展开，只会把整个数组当作一个非数值元素处理，最终结果会是0或者报错。

错误用法示例

假设我们有一个存储学生成绩的文档，scores字段是成绩数组：

// 学生成绩集合示例文档
// { "_id": 1, "name": "张三", "scores": [80, 90, 85] }
// { "_id": 2, "name": "李四", "scores": [75, 88, 92] }

如果直接使用以下聚合语句计算总分，会得到错误结果：

db.students.aggregate([
  {
    $project: {
      name: 1,
      totalScore: { $sum: "$scores" }
    }
  }
])
// 错误输出结果，totalScore为0或者不符合预期

正确用法：结合$unwind展开数组

要计算数组内整数的总和，需要先使用$unwind操作符把数组展开成多个文档，再对展开后的数值字段使用$sum。具体步骤如下：

• 第一步：使用$unwind将scores数组展开，每个数组元素会生成一个独立的文档
• 第二步：使用$group按照原文档的_id分组，对展开后的score字段使用$sum求和

正确的聚合语句如下：

db.students.aggregate([
  // 第一步：展开scores数组
  {
    $unwind: "$scores"
  },
  // 第二步：按原文档_id分组，求和展开后的scores
  {
    $group: {
      _id: "$_id",
      name: { $first: "$name" },
      totalScore: { $sum: "$scores" }
    }
  }
])
// 正确输出结果：
// { "_id": 1, "name": "张三", "totalScore": 255 }
// { "_id": 2, "name": "李四", "totalScore": 255 }

更简洁的用法：使用$reduce操作符

如果不想使用$unwind展开数组，也可以使用$reduce操作符直接对数组进行累加计算，$reduce可以遍历数组的每个元素，执行自定义的累加逻辑，代码更简洁。

db.students.aggregate([
  {
    $project: {
      name: 1,
      totalScore: {
        $reduce: {
          input: "$scores",
          initialValue: 0,
          in: { $sum: ["$$value", "$$this"] }
        }
      }
    }
  }
])
// 输出结果和上面的$unwind方式一致

这里的$$value是累加的当前值，$$this是数组当前的遍历元素，initialValue设置为0作为初始累加值。

常见避坑点

• 数组中包含非整数元素时，$sum会自动忽略非数值元素，比如数组是[80, "90", 85]，$sum会把字符串90转换为数值90再计算，如果无法转换则忽略该元素
• 如果数组为空，$sum的结果会是0，符合大多数场景的预期
• 使用$unwind展开数组时，如果原数组字段不存在或者是null，会直接丢弃该文档，需要提前使用$ifNull处理空值情况

如果需要处理可能的空数组场景，可以在聚合前先给空数组设置默认值：

db.students.aggregate([
  {
    $addFields: {
      scores: { $ifNull: ["$scores", []] }
    }
  },
  {
    $project: {
      name: 1,
      totalScore: { $sum: "$scores" }
      // 注意这里如果MongoDB版本支持直接对数组使用$sum可以简化，低版本还是需要$unwind或者$reduce
    }
  }
])

注意：部分新版本的MongoDB已经支持直接使用$sum对数组字段求和，会自动展开数组计算，但是为了保证兼容性，建议还是使用$unwind或者$reduce的方式实现，避免不同版本的行为差异。

MongoDBAggregation$sum数组求和修改时间：2026-06-25 18:03:34