本文详解如何在 spring data mongodb 中正确使用聚合管道实现基于多字段的去重查询，并将结果精准映射为自定义 dto（如 organizationdto），避免 `finddistinct()` 的局限性和手动拼接列表的冗余逻辑。
在 Spring Data MongoDB 中，当需要从集合中提取唯一组合的多字段数据（例如 organizationId + organizationName）并封装为 DTO 时，mongoTemplate.findDistinct() 无法满足需求——它仅支持单字段去重。而直接使用 GroupOperation 却常导致返回空对象，根本原因在于：默认分组结果结构与目标 DTO 不匹配。
MongoDB 聚合中，$group 阶段会将指定字段自动归入 _id 字段（可为 ObjectId、字符串或文档）。若未显式投影，AggregationResults<OrganizationDTO> 将尝试将 _id: { organizationId: "...", organizationName: "..." } 直接反序列化为 OrganizationDTO 的平级属性，但因字段路径不一致（_id.organizationId ≠ organizationId），Jackson 或 Spring 的映射器无法识别，最终生成空对象。
✅ 正确做法是：在 group 后添加 $project 阶段，将 _id 内嵌字段“提升”为顶层字段，使其结构与 OrganizationDTO 完全对齐。
以下是推荐的完整实现：
public List<OrganizationDTO> findDistinctOrganizations(Set<String> statusList) {
// 1. 匹配条件：status 在指定集合中
MatchOperation match = Aggregation.match(
Criteria.where("status").in(statusList)
);
// 2. 分组：按 organizationId 和 organizationName 联合去重
// 注意：此处使用 Fields.from() 显式构造复合 _id 文档
GroupOperation group = Aggregation.group()
.field("organizationId").first("$organizationId")
.field("organizationName").first("$organizationName");
// 3. 投影：将分组结果中的字段提升至根层级，匹配 DTO 结构
ProjectionOperation project = Aggregation.project()
.and("_id.organizationId").as("organizationId")
.and("_id.organizationName").as("organizationName")
.andExclude("_id"); // 排除原始 _id 字段，避免干扰
Aggregation aggregation = Aggregation.newAggregation(match, group, project);
AggregationResults<OrganizationDTO> results =
mongoTemplate.aggregate(aggregation, "user", OrganizationDTO.class);
return results.getMappedResults();
}⚠️ 关键注意事项：
- GroupOperation 构建方式很重要：推荐使用 Aggregation.group().field(...).first(...) 显式声明字段，而非 Fields.fields("a", "b") —— 后者在旧版 Spring Data MongoDB 中可能生成不兼容的 _id 结构。
- $project 必不可少：它负责字段“展平”，确保输出 JSON 形如 { "organizationId": "org1", "organizationName": "Org One" }，而非 { "_id": { "organizationId": "...", "organizationName": "..." } }。
- DTO 必须有无参构造函数 + 标准 getter/setter：Spring 默认使用反射+PropertyAccessor 进行映射，Lombok 注解需配合 @Data 或显式声明。
- 集合名建议显式传入：mongoTemplate.aggregate(..., "user", ...) 比 User.class 更可靠，避免因实体类 @Document(collection = "...") 配置缺失导致错误。
? 补充优化（可选）：
若后续需支持分页或统计总数，可在 match 后加入 count() 或结合 skip()/limit()；若组织名称可能存在空值，可在 match 中追加 and("organizationId").ne(null).and("organizationName").ne("") 条件增强健壮性。
综上，聚合管道（match → group → project）是 Spring MongoDB 处理多字段去重 DTO 查询的标准、高效且可维护的解决方案，远优于多次 findDistinct() + 手动合并的“伪去重”方式。
