$arrayelemat 返回 null 的最常见原因是数组为空、索引越界（正数索引 ≥ 数组长度，或负数索引

为什么 $arrayElemAt 返回 null 而不是预期值

最常见原因是数组为空、索引越界（正数索引 ≥ 数组长度，或负数索引 null，容易误判为“查到了空值”。

实操建议：

• 先用 $isArray + $size 验证字段是否为非空数组，再执行 $arrayElemAt
• 负数索引从末尾计数：-1 是最后一个，-2 是倒数第二个——别当成 Python 的 slice 语义（arr[-1:] 那种）
• 如果源字段可能缺失，用 $ifNull: ["$tags", []] 提供默认空数组，避免 $arrayElemAt 对 null 操作

$arrayElemAt 在 $project 和 $addFields 中的写法差异

两者语法完全一致，区别只在语义：$project 默认丢弃未显式列出的字段，$addFields 保留全部原有字段。选哪个取决于你是否想精简输出。

示例（取 tags 数组第一个元素）：

{
  $addFields: {
    firstTag: { $arrayElemAt: ["$tags", 0] }
  }
}

注意点：

Boxy

Boxy是一款AI开发辅助工具，CodeSandbox推出的AI编程助手。

下载

• 第一个参数必须是数组表达式，不能直接写字符串如 "$tags" —— 它会被当作文本字面量，不是字段引用
• 第二个参数必须是整数表达式，支持变量如 "$index"，但该变量值也得是整数，否则运行时静默失败
• 不要嵌套写成 { $arrayElemAt: [{ $filter: ... }, 0] } 而不加括号包裹整个 $filter 表达式，外层必须是合法数组表达式

替代方案：用 $first 或 $last 更安全的场景

如果你只是取首/尾元素，$first 和 $last 比 $arrayElemAt 更鲁棒：它们对空数组返回 null，但不会因索引计算错误崩溃，语义也更清晰。

比如取第一个非空 tag：

{
  $addFields: {
    primaryTag: {
      $first: {
        $filter: {
          input: "$tags",
          cond: { $ne: ["$$this", ""] }
        }
      }
    }
  }
}

这时候用 $first 就比 $arrayElemAt: [..., 0] 更合适——它天然适配过滤后可能为空的结果。

• $first / $last 只能取端点，不能随机索引；需要中间位置时仍得用 $arrayElemAt
• 聚合阶段中若已用 $reduce 或 $map 生成新数组，$arrayElemAt 是唯一能按需索引的方式

性能与索引注意事项

$arrayElemAt 是纯内存计算操作，不触发索引，也不影响查询计划。但它常出现在 $match 后的阶段，所以前序是否能走索引才是关键。

容易被忽略的一点：

• 如果依赖 $arrayElemAt 的结果做后续 $match（例如 { firstTag: "urgent" }），这个匹配无法利用 tags 字段上的多键索引——MongoDB 不支持对聚合表达式结果建立索引
• 高频按某位置元素查询，应考虑预计算并存为独立字段（如 primary_tag: "urgent"），再对该字段建索引
• 数组很大（比如上万元素）时，$arrayElemAt 本身无性能压力，但上游生成该数组的阶段（如 $push、$addToSet）可能成为瓶颈

实际用的时候，别只盯着 $arrayElemAt 写对没，重点看它前面那个数组是怎么来的——是不是已经膨胀了，有没有必要全量构造。