$arrayElemAt 返回 null 的常见原因包括数组为空、下标越界（正数≥数组长度或负数＜-数组长度）、输入字段非数组类型；MongoDB 静默返回 null 而不报错，易误判为无数据；需用 $isArray 和 $size 防御性校验。
为什么 $arrayElemAt 返回 null 而不是预期值？
常见原因是数组为空、下标越界（正数超出长度，负数小于 -数组长度），或输入字段根本不是数组类型。MongoDB 不会报错，而是静默返回 null，容易误判为“查不到数据”。
- 确保上游阶段输出的是真实数组，比如用
$push或$addToSet构建的字段，而非字符串或null - 下标必须是整数：支持负数（从末尾倒数），但
-0和0等价，-1是最后一个元素 - 若不确定数组是否存在或是否为空，先用
$cond+$isArray+$size做保护性判断
$arrayElemAt 在 $project 和 $addFields 中的写法差异
两者语法完全一致，区别只在语义：$project 会丢弃未显式列出的字段，$addFields 保留全部原有字段。日常推荐用 $addFields 避免意外丢失数据。
- 正确格式：
{ $arrayElemAt: [ "$tags", 0 ] }—— 注意是数组字面量，第一个元素是字段路径，第二个是下标表达式 - 下标可以是变量：
{ $arrayElemAt: [ "$items", { $subtract: [{ $size: "$items" }, 1] } ] }取最后一个元素 - 不能直接写
"$tags.0"或"$tags[0]"，MongoDB 不支持这种点号/方括号索引语法
和 $first/$last 比，什么时候必须用 $arrayElemAt？
$first 和 $last 只能取首尾，且要求输入是“非空数组”；一旦数组为空就出 null，且无法指定任意位置。而 $arrayElemAt 是唯一能按任意下标取值的操作符。
- 需要取第 2 个元素（下标 1）、倒数第 3 个（下标 -3）时，只能用
$arrayElemAt - 配合
$range+$map可批量提取多个下标，例如：{ $map: { input: { $range: [0, 3] }, as: "i", in: { $arrayElemAt: ["$scores", "$$i"] } } } - 性能上无明显差异，但过度嵌套计算下标（如多层
$cond）会影响可读性和调试成本
聚合中处理缺失下标的安全模式
直接硬写下标风险高，尤其当数组长度动态变化时。更稳妥的方式是先判断再取值，避免 null 传播到后续阶段。
- 示例：安全取第一个非空标签，否则用默认值
"unknown"：{ $addFields: { primaryTag: { $cond: { if: { $and: [ { $isArray: "$tags" }, { $gt: [{ $size: "$tags" }, 0] } ]}, then: { $arrayElemAt: ["$tags", 0] }, else: "unknown" } } } } - 注意
$size对非数组输入返回0，所以必须先用$isArray排除非数组情况 - 如果下游要用该字段做匹配（如
$match），记得提前处理null，否则可能漏掉本应命中的文档
null 会悄悄影响后续所有逻辑 —— 尤其在嵌套管道或与其他条件组合时，最容易被忽略的是数组类型校验这一步。 
