MongoDB的文档模型天然支持数组类型，一个字段里可以存放多个值。在聚合管道中，我们经常需要从数组里取出某个特定位置的元素，比如取第一个、最后一个，或者按条件筛选后取第一条记录。$arrayElemAt就是MongoDB聚合运算符中专门用来解决这个问题的工具，它语法简单但功能实用，理解它的正负索引机制和边界行为，能让我们在编写聚合查询时事半功倍。
$arrayElemAt的基本语法与工作原理
$arrayElemAt的语法结构是{ $arrayElemAt: [ <array>, <idx> ] }，第一个参数是数组表达式，可以是文档中的数组字段，也可以是其他运算符返回的数组结果；第二个参数是索引值，必须是能解析为整数的表达式。返回值就是数组中该索引位置对应的元素。
它的索引规则和很多语言类似但有一个特色：支持负数索引。正数索引从0开始，表示从数组头部往后数；负数索引从-1开始，表示从数组尾部往前数，-1就是最后一个元素，-2是倒数第二个。这个设计在取“最新一条记录”这类场景中特别方便，因为很多业务数据是按时间顺序追加的，最后一个元素往往就是最新的。
db.orders.aggregate([
{
$project: {
item: 1,
// 取数组第一个元素，索引为0
firstItem: { $arrayElemAt: ["$items", 0] },
// 取数组最后一个元素，索引为-1
lastItem: { $arrayElemAt: ["$items", -1] }
}
}
])上面的例子假设orders集合中每个文档有一个items数组字段，我们同时在投影中取出了第一个和最后一个元素。注意$items用引号包裹，这是引用字段的标准写法，直接写$items不带引号在某些上下文中会解析失败。
与其他运算符配合的实际应用
$arrayElemAt真正的威力在于它可以和返回数组的运算符组合使用。最经典的组合是先$filter筛选数组，再用$arrayElemAt取出第一条匹配的记录，相当于对数组做了一次“查找第一个满足条件的元素”的操作。
db.users.aggregate([
{
$project: {
firstActiveOrder: {
$arrayElemAt: [
{
$filter: {
input: "$orders",
as: "order",
cond: { $eq: ["$$order.status", "active"] }
}
},
0
]
}
}
}
])这段聚合语句先使用$filter把status为active的订单筛出来，得到一个新数组，然后$arrayElemAt取索引0的元素。如果没有任何active订单，$filter返回空数组，$arrayElemAt取不到元素，字段值就是缺失的，不会抛出异常。
另一个常见组合是与$sortArray配合。先对数组按某个字段排序，再取第一个或最后一个，就能得到数组中的最大值或最小值对应的完整文档。比如取评分最高的评论、金额最大的交易记录，都可以用这个思路实现，代码结构清晰且全部在服务端完成，避免了把大数组拉到应用层处理的开销。
边界情况处理与$slice的对比
使用$arrayElemAt时必须清楚它的边界行为。如果索引超出了数组范围，比如数组有3个元素却取索引5，返回结果是缺失值而不是错误；如果索引是null或者无法解析为整数，同样返回缺失值。但如果传入的第一个参数根本不是数组也不是缺失值，比如是一个字符串或数字，聚合查询会直接报错。所以在数据质量不稳定的集合上，建议先用$type判断字段类型，或者用$isArray做条件判断，保证输入的合法性。
db.products.aggregate([
{
$project: {
firstTag: {
$cond: {
if: { $isArray: "$tags" },
then: { $arrayElemAt: ["$tags", 0] },
else: null
}
}
}
}
])另外要区分$arrayElemAt和$slice这两个运算符。$arrayElemAt返回的是单个元素，而$slice返回的是子数组，即使只取一个元素，$slice返回的也是包含一个元素的数组。如果下游逻辑期望的是单个对象，用$slice还得再拆一层；反过来如果需要连续截取一段元素，$slice才是正确的选择。简单记法：取一个用$arrayElemAt，取一段用$slice。
总结一下，$arrayElemAt凭借正负索引机制和宽松的越界处理，成为聚合管道中操作数组的基础工具。配合$filter、$sortArray等运算符，它能优雅地解决“取第一条匹配记录”“取最新数据”这类高频需求。实际使用中注意校验输入是否为数组类型，并根据返回单元素还是子数组的需求，在$arrayElemAt和$slice之间做出正确选择，就能写出既健壮又高效的聚合查询。
MongoDB聚合管道$arrayElemAt修改时间：2026-09-01 06:26:43