MongoDB如何获取指定ID文档内数组字段的所有对象

问题核心需求 #

根据传入的文档ID，匹配对应文档后获取该文档下Grades数组的全部内容。Grades是由多个成绩对象组成的数组，每个对象包含科目、分数等多个属性。

现有集合结构示例 #

{
   "_id" : ObjectId("5c6eba356fd07954a489067c"),
   "StudentName" : "David",
   "StudentAge" : 28,
   "Grades": [{"subject": "Math", "grade": 95}, {"subject": "English", "grade": 88}]
}

注：原示例存在JSON语法笔误：StudentAge字段后缺少逗号，成绩对象内键值对误用逗号分隔，已修正。

原有写法问题说明 #

• 第一版基础查询写法问题：
  1. 类型拼写错误：MongoDB Java驱动中find()返回的类型是FindIterable，不存在Filterabel类型
  2. 未做结果提取：find()返回的是匹配文档的可迭代结果集，按ID查询只会匹配唯一一条文档，未调用first()取单条结果、也未做字段提取，无法直接拿到Grades内容
• 第二版投影查询写法问题：
  1. 字段名大小写不匹配：MongoDB对字段名大小写严格敏感，集合中字段为大写开头的Grades，写法中用了小写grades，无法匹配到目标字段
  2. 投影逻辑错误：Projections.computed用于生成自定义计算字段，传入lt("grades.qty", 20)只会返回一个布尔值（判断数组内是否存在qty小于20的元素），不会返回数组本身内容

正确实现代码 #

场景1：需要返回完整学生实体，直接获取Grades属性 #

如果已经定义了StudentEntity实体类做映射，查询到完整实体后直接调用get方法取Grades即可：

// 构建主键查询条件，注意主键字段名固定为_id
Document findByIdQuery = new Document("_id", new ObjectId(id));
// 查询单条匹配文档，映射为实体类
StudentEntity student = mongoCollection.find(findByIdQuery).first();
// 判空后获取Grades数组，避免空指针
List<Grade> grades = student != null ? student.getGrades() : Collections.emptyList();

场景2：仅需要Grades数组，不需要其他字段 #

通过投影只返回目标字段，减少不必要的数据传输：

Document findByIdQuery = new Document("_id", new ObjectId(id));
// 配置投影：排除默认返回的_id字段，只包含Grades字段
Document resultDoc = mongoCollection.find(findByIdQuery)
        .projection(Projections.fields(
                Projections.excludeId(),
                Projections.include("Grades")
        ))
        .first();
// 从结果文档中提取Grades数组
List<Document> grades = resultDoc != null ? resultDoc.getList("Grades", Document.class) : Collections.emptyList();

额外注意事项 #

• 若后续需要过滤Grades数组内符合特定条件的元素（例如只取及格的成绩），再使用$elemMatch或聚合管道的$filter操作符，获取全量数组直接用投影包含字段即可
• 确保传入的id字符串可以转换为合法的ObjectId，否则会抛出参数异常
• 所有查询、投影中使用的字段名必须和集合中存储的字段名完全一致，包括大小写、拼写

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