$arrayElemAt 返回 null 的常见原因是数组为空、索引越界或字段非数组类型；需用{$type: "array"}和$size校验，仅在$project/$set等表达式上下文中使用，支持动态索引及多层嵌套分步提取。
为什么 $arrayElemAt 返回 null 而不是预期值？
常见原因是数组为空、索引越界（正数超出长度，负数小于 -数组长度），或输入字段根本不是数组类型。MongoDB 不会报错，而是静默返回 null，容易误判为数据缺失。
- 确认字段确实是数组：
{$type: "array"}在$match阶段过滤 - 用
$size检查长度，再结合索引判断是否安全访问：{$lt: [{$size: "$tags"}, 2]}保证至少有 2 个元素才取索引 1 - 负索引从末尾开始计数，
-1是最后一个，-2是倒数第二个——但-0和0等价，不是“最后一个”
$arrayElemAt 在聚合管道里怎么写才不报错？
它只能用在表达式上下文（如 $project、$addFields、$set），不能直接放在 $match 或 $sort 中作为查询条件。
- 正确写法：
{$set: {firstTag: {$arrayElemAt: ["$tags", 0]}}} - 错误写法：
{$match: {firstTag: {$arrayElemAt: ["$tags", 0]}}}—— 这会报Invalid $match expression - 若需按首个元素筛选，先
$set提取，再$match：{$set: {primaryTag: {$arrayElemAt: ["$tags", 0]}}}, {$match: {"primaryTag": "urgent"}}
和 $first / $last 比，$arrayElemAt 有什么不可替代的场景？
$first 和 $last 只能取头尾，而 $arrayElemAt 支持任意位置（包括动态计算索引），这是关键差异。
- 取中间元素：
{$arrayElemAt: ["$scores", {$floor: {$divide: [{$size: "$scores"}, 2]}}]} - 根据其他字段决定索引：
{$arrayElemAt: ["$items", {$cond: [{ $eq: ["$priority", "high"] }, 0, -1]}]} - 注意：索引必须是整数，浮点数会自动截断（
2.9→2），不是四舍五入
嵌套数组里怎么用 $arrayElemAt 提取深层元素？
它只作用于一层数组，无法直接“穿透”嵌套结构。想取 comments.0.replies.1.author，得拆成多步。
- 先提取外层数组元素：
{$arrayElemAt: ["$comments", 0]}得到第一个 comment 对象 - 再对结果取字段：
{$arrayElemAt: [{$ifNull: ["$$comment.replies", []]}, 1]}，注意要处理replies可能不存在的情况 - 推荐用
$let绑定中间结果，避免重复计算：{$let: {vars: {firstComment: {$arrayElemAt: ["$comments", 0]}}, in: {$arrayElemAt: [{$ifNull: ["$$firstComment.replies", []]}, 1]}}}
实际用的时候，最容易漏掉的是空数组和字段类型校验——明明写了索引 0，结果全 null，往往不是语法错，而是数据本身没按预期建模。
