$arrayElemAt 返回 null 的最常见原因是数组为空、索引越界（正数索引 ≥ 数组长度，或负数索引 < -数组长度）或输入字段非数组类型，MongoDB 静默返回 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] }
}
}
注意点：
- 第一个参数必须是数组表达式，不能直接写字符串如
"$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 写对没，重点看它前面那个数组是怎么来的——是不是已经膨胀了，有没有必要全量构造。 
