如何使用MongoDB中$map批量转换数组元素？-MongoDB-PHP中文网

$map 是 mongodb 聚合管道中用于对数组每个元素执行相同操作并返回新数组的表达式操作符，适用于查询时批量格式转换（如 id 映射、时间戳转字符串、添加序号等），需配合 $project 或 $addfields 使用，要求 input、as、in 三参数齐全，不支持过滤或累加，应与 $filter/$reduce 配合使用。

如何使用mongodb中$map批量转换数组元素？

什么是 $map，它适合解决什么问题

$map 是 MongoDB 聚合管道中的一个表达式操作符，用于对数组字段的每个元素执行相同的操作并返回新数组。它不修改原数据，只在聚合阶段临时转换——所以别指望用它直接更新文档里的数组；它真正有用的地方是：查的时候就完成格式转换，比如把 userIds 数组批量转成带 name 和 id 的对象、把时间戳转成日期字符串、给每个元素加序号等。

注意：$map 必须配合 $project 或 $addFields 使用，不能单独出现在 pipeline 里。

基本语法和必须传的参数

$map 接收三个键： input（源数组）、as（当前元素的变量名，不带 $$ 前缀）、in（对每个元素做的表达式）。漏掉任意一个都会报错 "$map requires 'input' field" 或 "'as' is required"。

常见写法示例：

{
  $map: {
    input: "$tags",
    as: "tag",
    in: { name: "$$tag", length: { $strLenCP: "$$tag" } }
  }
}

这里 $$tag 才是实际引用变量的方式（双美元符号），as: "tag" 只是声明名字，不是赋值语句。

input 必须是数组，如果字段可能为 null 或缺失，先用 $ifNull 包一层，否则整个表达式会失败
as 值只能是合法标识符（不能含点、空格、特殊字符），且不能与外层字段名冲突（比如外层有 item 字段，就别设 as: "item"）
in 里所有字段引用都必须加 $$，写成 $tag 会被当成字段路径解析，结果通常是 null

和 $reduce / $filter 混用时的典型陷阱

想在 $map 里做条件过滤或累加？别硬套——$map 本身不支持跳过元素或中断循环。需要“筛选后映射”，得先 $filter 再 $map；需要“边遍历边累计”，得换 $reduce。

mongodb-query

用于调试和故障排查，查询MongoDB数据库。用户需要时可以： (1) 列出所有数据库； (2) 列出数据库中的集合； (3) 执行MongoDB查询或命令。

下载

比如想把数组中大于 10 的数翻倍，错误写法：

{
  $map: {
    input: "$numbers",
    as: "n",
    in: { $cond: [{ $gt: ["$$n", 10] }, { $multiply: ["$$n", 2] }, "$$n"] }
  }
}

这其实没过滤，只是做了条件替换。真要过滤，得这样：

{
  $map: {
    input: {
      $filter: {
        input: "$numbers",
        cond: { $gt: ["$$this", 10] }
      }
    },
    as: "n",
    in: { $multiply: ["$$n", 2] }
  }
}