MongoDB如何递归移除文档中的所有null字段？

我之前也遇到过类似的需求——默认的更新操作只能处理顶层字段，要搞定未知深度的嵌套结构确实得用递归逻辑。下面给你两种实用的方案，都能完美处理你给出的示例场景：

方案一：用$function实现递归清理（最直观） #

MongoDB 4.4及以上版本支持的$function允许我们在聚合管道里写自定义JS函数，刚好能用来递归遍历整个文档，把所有值为null的字段都删掉。

完整聚合管道代码 #

db.yourCollection.aggregate([
  {
    $addFields: {
      cleanedData: {
        $function: {
          body: function(doc) {
            // 定义递归清理的内部函数
            const cleanObject = (obj) => {
              // 如果是null直接返回（后续会被过滤）
              if (obj === null) return null;
              // 处理数组：遍历每个元素并递归清理
              if (Array.isArray(obj)) {
                return obj.map(item => cleanObject(item)).filter(item => item !== null);
              }
              // 处理对象：过滤掉值为null的键，同时递归清理子对象
              if (typeof obj === 'object') {
                return Object.fromEntries(
                  Object.entries(obj)
                    .filter(([key, value]) => value !== null)
                    .map(([key, value]) => [key, cleanObject(value)])
                );
              }
              // 基础类型直接返回
              return obj;
            };
            return cleanObject(doc);
          },
          args: ["$$ROOT"], // 传入当前整个文档
          lang: "js"
        }
      }
    }
  },
  // 把清理后的文档设为根文档
  { $replaceRoot: { newRoot: "$cleanedData" } },
  // 可选：如果要直接更新原集合，加上这一步（注意会替换整个集合，先测试！）
  // { $out: "yourCollection" }
])

测试你的示例输入 #

输入文档：

{ "id": 14770467, "f1": "a", "f2": null, "f3": [ { "id": 76946819, "f4": null } ] }

执行上面的管道后，输出完全符合你的期望：

{ "id": 14770467, "f1": "a", "f3": [ { "id": 76946819 } ] }

方案二：纯聚合表达式（无JS依赖） #

如果你的MongoDB版本低于4.4，或者不想用JS函数，可以用原生聚合表达式实现递归，但代码会繁琐很多。核心是用$reduce遍历对象的键值对，结合$cond判断是否保留字段，同时递归处理嵌套对象和数组。不过这种写法很长，可读性远不如方案一，如果你需要的话可以再细化。

额外注意事项 #

• 如果数组里有单独的null元素（比如[1, null, 2]），方案一会把它过滤掉；如果想保留数组中的null，只移除对象里的null字段，修改数组处理部分的逻辑即可：把.filter(item => item !== null)去掉。
• 使用$out更新原集合前，一定要先单独执行聚合管道查看结果，确认没问题再执行，避免数据意外丢失。
• 对于旧版本MongoDB，可以用客户端脚本（比如Node.js、Python）批量拉取文档，递归清理后再批量更新回去，逻辑和方案一的cleanObject函数一致。

内容的提问来源于stack exchange，提问作者R. Zhu