MongoDB 的聚合管道通常用点号路径直接访问字段，例如 $translations.zh。这种方式要求字段名在建管道时固定写死，一旦字段名来自文档数据或外部变量，点号路径就无法工作。$getField 操作符正是为解决这种动态字段名取值而设计的，它允许把字段名当成一个表达式来求值。无论是从子文档中取某个语言的翻译，还是根据配置键从数据字典里读值，都可以用 $getField 简单实现。下面先从语法入手。

一、$getField 的基础语法与静态点号路径的对比

$getField 接受两个参数：field 和 input。其中 field 可以是任意能够解析为字符串的表达式，input 则指定从哪个文档对象中取值。如果省略 input，默认使用当前正在处理的文档。例如下面的管道中，field: "status" 是一个字符串常量，因此 $getField 会返回当前文档中的 status 字段值，效果与 $status 等价。

db.orders.aggregate([
  {
    $project: {
      statusField: "$status",
      dynamicStatus: {
        $getField: { field: "status" }
      }
    }
  }
])

仅看硬编码字段名，$getField 似乎没什么优势。它的价值在于 field 参数可以是变量、字段路径或任何返回字符串的表达式。比如文档里有一个 fieldToRead 字段，其值可能是 price，也可能是 stock，这时就可以让 $getField 根据 $fieldToRead 的值动态决定读取哪一个字段。

db.products.aggregate([
  {
    $project: {
      selectedField: {
        $getField: { field: "$fieldToRead" }
      }
    }
  }
])

这里有一个解析规则需要特别注意。表达式里不带 $ 前缀的字符串是常量，带 $ 前缀的字符串是字段路径表达式。field: "status" 表示取名为 status 的字段，field: "$fieldToRead" 表示先读取 fieldToRead 字段的值，再用这个值作为目标字段名。如果某个字段名本身就以 $ 开头，比如 $meta，直接写字符串会被误认为字段路径表达式，此时需要用 $literal 把 $meta 显式声明为字符串常量。

二、处理不固定字段名：多语言、动态键和列表映射

多语言内容存储是一个典型的动态字段名场景。假设文章文档包含一个 translations 子文档，键名是语言代码，另外还有一个 locale 字段表示当前需要展示的语言。如果直接用点号路径，每种语言都要写一个分支；而 $getField 可以直接把 locale 的值当作字段名，从 translations 子文档中取出对应的翻译内容。

db.articles.aggregate([
  {
    $project: {
      title: {
        $getField: {
          field: "$locale",
          input: "$translations"
        }
      }
    }
  }
])

如果指定的语言在 translations 中不存在，$getField 会返回 null。实际业务中一般希望有一个默认回退值，比如找不到当前语言时回退到英文。由于 $getField 没有提供默认值参数，可以和 $ifNull 搭配使用。下面的代码会先尝试取 locale 对应的翻译，取不到时再取 en 字段的值。

db.articles.aggregate([
  {
    $project: {
      title: {
        $ifNull: [
          { $getField: { field: "$locale", input: "$translations" } },
          { $getField: { field: "en", input: "$translations" } }
        ]
      }
    }
  }
])

另一个常见场景是列表字段映射。文档中有一个 items 数组，每个元素包含 key 和 value，同时文档里还有一个 values 子文档保存实际数据。此时可以用 $map 遍历数组，对每个元素使用 $getField 从 values 中取出 key 对应的真实值。这样就把数组元素中的逻辑键名转换成了实际数据。

db.metrics.aggregate([
  {
    $project: {
      mapped: {
        $map: {
          input: "$items",
          as: "item",
          in: {
            key: "$$item.key",
            actual: {
              $getField: {
                field: "$$item.key",
                input: "$values"
              }
            }
          }
        }
      }
    }
  }
])

这段代码中，$$item.key 是 $map 内部定义的变量，表示当前数组元素的 key 字段。把它传给 $getField 的 field 参数，就能实现每个元素根据自己的键名去 values 子文档读取对应数据。这种组合方式在处理配置项映射、指标抽取、权限字段解析时非常实用。

三、结合 $objectToArray 和 $setField 完成动态键往返

当需要一次性处理文档中的所有动态字段时，$objectToArray 会把子文档拆成 { k: 字段名, v: 字段值 } 数组，之后可以用数组操作符进行过滤、排序或计算，最后再用 $arrayToObject 还原。这种方式适合批量处理，但代价是文档结构会被展开，表达式也相对复杂。$getField 则更适合按已知键精准取值，两者可以互补。

db.products.aggregate([
  {
    $set: {
      kv: { $objectToArray: "$attributes" }
    }
  },
  {
    $project: {
      selected: {
        $arrayToObject: {
          $filter: {
            input: "$kv",
            as: "pair",
            cond: { $in: [ "$$pair.k", ["price", "stock"] ] }
          }
        }
      }
    }
  }
])

上面这段管道先通过 $objectToArray 展开 attributes 子文档，再用 $filter 只保留 price 和 stock 两个字段，最后还原成一个新的子文档。如果要在这个新子文档中进一步动态取值，可以在后续阶段继续使用 $getField。这种写法适合字段数量较多、需要按白名单或黑名单筛选的场景。

与 $getField 对称的是 $setField，它可以动态设置文档中的字段值。比如把某个动态键的值修改后再写回，先使用 $setField 指定 field 为表达式，input 为目标文档，value 为新的值。两者语法相似，掌握一个之后另一个也很容易上手。

四、容易踩的解析歧义、类型校验与性能建议

解析歧义是最容易出错的地方。前面提到 field: "$fieldToRead" 会先解析 fieldToRead 字段的值，再用该值去取字段。如果文档中确实存在一个名为 $fieldToRead 的字段，而你又想直接读取这个字段，就必须使用 $literal。例如文档结构是 { _id: 1, $meta: "abc", fieldToRead: "$meta" }，若写 field: "$fieldToRead"，最终得到的是 abc，因为先取出 fieldToRead 的值为 $meta，再读取 $meta 字段。若要直接获取名为 $meta 的字段，应写成 field: { $literal: "$meta" }。这个差异在字段名包含 $ 前缀时尤其重要。

类型校验同样不能忽略。$getField 的 input 参数必须是对象。如果传入的是数组或标量，聚合会直接报错。在文档结构不完全可控的情况下，可以先使用 $type 检查字段类型，再用 $cond 决定是否执行 $getField。对于可能为数组的字段，建议先用 $unwind 拆开，或者用 $arrayElemAt 取第一个元素，确保传入的 input 是一个对象。

性能方面，$getField 不会利用任何索引，它是在聚合管道内存中完成字段解析和取值。对于已经过滤后的小批量文档，性能影响可以忽略；但如果数据量巨大且动态字段名高度分散，频繁的 $getField 配合 $objectToArray 可能导致内存压力增大。这时更合理的做法是在写入侧规范结构，把动态键转成 { key: "xxx", value: "yyy" } 数组，并为 key 建立索引。这样读取时既可以利用索引过滤，也能避免聚合阶段的复杂表达式。

缺失字段返回 null 是 $getField 的默认行为，但要注意 null 和字段实际值为 null 无法区分。如果业务上必须区分，可以先用 $getField 取值，再配合 $ifNull 补默认值，或者在写入时保证动态字段都有明确的占位值。总体而言，$getField 是处理动态字段名的首选操作符，只要理解它的解析规则和类型约束，就能在聚合管道中写出更简洁、更易维护的表达式。