如何使用Aggregation.lookup填充文档中ObjectId列表对应的关联数据

MongoDB 3.2及以上版本的$lookup原生支持本地字段为ObjectId数组的关联场景，不需要额外拆分数组，直接按以下方式配置即可：

1. 原生MongoDB查询示例 #

db.users.aggregate([
  // 可选：过滤指定用户，只查你需要的单条学生详情
  {
    $match: {
      _id: ObjectId("目标用户的_id值")
    }
  },
  {
    $lookup: {
      from: "sports", // 关联的体育项目集合名
      localField: "sports", // 用户表中存储ObjectId数组的字段
      foreignField: "_id", // 体育项目表的关联主键
      as: "sports" // 填充后返回的字段名，可直接覆盖原有数组
    }
  }
])

执行后返回的用户文档中，sports字段会直接替换为对应体育项目的完整文档列表。

2. Spring Data MongoDB Aggregation写法 #

如果你使用Spring Data MongoDB的聚合API，对应写法如下：

// 构造聚合查询
Aggregation aggregation = Aggregation.newAggregation(
  // 可选：匹配指定用户
  Aggregation.match(Criteria.where("_id").is(targetUserId)),
  // 配置关联查询，直接支持数组类型的本地字段
  Aggregation.lookup("sports", "sports", "_id", "sports")
);
// 执行查询并映射为User实体类
AggregationResults<User> result = mongoTemplate.aggregate(aggregation, "users", User.class);
User userDetail = result.getUniqueMappedResult();

注意事项 #

• 确保用户集合sports数组存储的元素类型和体育项目集合的_id类型完全一致，均为ObjectId，避免类型不匹配导致关联无结果
• 若需要对填充后的体育项目列表做过滤、排序等二次处理，可在lookup阶段后追加unwind、match、group等聚合阶段实现

内容的提问来源于stack exchange，提问作者bnayagrawal