使用 MongoTemplate 执行 Aggregation.group() 时，分组键默认存于 _id 字段而非原始字段名（如 "name"），若未在后续 project 阶段显式提取 _id，会导致 Java 实体中对应属性为 null。
使用 `mongotemplate` 执行 `aggregation.group()` 时，分组键默认存于 `_id` 字段而非原始字段名（如 `"name"`），若未在后续 `project` 阶段显式提取 `_id`，会导致 java 实体中对应属性为 `null`。
在 Spring Data MongoDB 中，Aggregation.group("name") 并不会将分组值自动赋给输出文档的 name 字段——它实际生成的 $group 阶段是：
{ "$group": { "_id": "$name", "check_count": { "$sum": 1 } } }因此，聚合结果的结构为 { "_id": "Alice", "check_count": 61 }，而非 { "name": "Alice", "check_count": 61 }。Java 实体 Response 中的 name 字段因无法绑定 _id 字段而始终为 null。
✅ 正确做法是在 group 后使用 Aggregation.project() 显式将 _id 投影为业务字段名：
Aggregation aggregation = Aggregation.newAggregation(
Aggregation.match(Criteria.where("modality").is("check")),
Aggregation.group("name").count().as("check_count"),
Aggregation.project()
.and("_id").as("name") // 关键：将 _id 映射为 name
.and("check_count").as("check_count")
);
AggregationResults<Response> result = mongoTemplate.aggregate(aggregation, "user", Response.class);同时，请注意以下关键细节：
-
实体字段类型需匹配：Response.check_count 声明为 string（小写 s）是错误的，应为 int 或 Long（因 count() 返回整型）：
class Response { private String name; private Long check_count; // ✅ 修正类型 // 构造器、getter/setter... } @Document 类建议使用 @Document(collection = "user") 仅用于实体类（如 User），Response 是 DTO，无需注解。
-
可选增强写法（更清晰）：使用 group() 的静态导入和链式投影提升可读性：
import static org.springframework.data.mongodb.core.aggregation.Aggregation.*; // ... Aggregation aggregation = newAggregation( match(Criteria.where("modality").is("check")), group("name").count().as("check_count"), project("_id").and("check_count").as("check_count") // 等价于 and("_id").as("name") );
总结：MongoDB 聚合管道中 group(key) 的输出结构天然以 _id 为分组键容器，这是 BSON 协议与 $group 操作符的设计约定。Spring Data MongoDB 忠实还原该行为，开发者必须通过 project() 主动解包 _id，才能将其映射到 Java 对象的任意命名字段。忽略此步骤是导致字段 null 的最常见原因。
