如何通过Spring MongoTemplate实现字段投影并设置字段别名

开发者阿泽

2026-6-18

在MongoTemplate中实现带字段别名的数据查询过滤

要给查询结果的字段设置别名，单纯用Query.fields().include()无法实现，得借助MongoDB的**聚合（Aggregation）**功能，通过$project阶段定义字段别名。下面是具体实现方案：

1. 构建聚合管道

先把你的过滤条件转换成聚合的MatchOperation，再用ProjectionOperation指定字段与对应别名：

// 1. 构建匹配条件（对应原Query中的Criteria逻辑）
MatchOperation matchOp = Aggregation.match(Criteria.where("column1").is("yes"));

// 2. 构建投影操作，设置字段别名
// 格式：and("原字段名").as("别名")
ProjectionOperation projectOp = Aggregation.project()
    .and("column1").as("new_column1")  // 给column1设置别名new_column1
    .and("column2").as("new_column2")  // 给column2设置别名new_column2
    .and("column3").as("new_column3"); // 按需添加更多字段映射

// 3. 组装聚合管道，开启磁盘使用（对应原Query的allowDiskUse(true)）
Aggregation aggregation = Aggregation.newAggregation(matchOp, projectOp)
    .withOptions(AggregationOptions.builder().allowDiskUse(true).build());

2. 执行聚合查询并获取结果

通过MongoTemplate执行聚合，可根据需求选择返回类型：

// 方式1：返回List<Document>，直接查看别名后的字段结构
List<Document> results = mongoTemplate.aggregate(aggregation, "你的集合名称", Document.class).getMappedResults();

// 方式2：映射到自定义实体类，需在实体字段上用@Field指定别名
// 示例实体类：
// public class CustomResult {
//     @Field("new_column1")
//     private String column1;
//     // 其他字段对应别名...
// }
List<CustomResult> entityResults = mongoTemplate.aggregate(aggregation, "你的集合名称", CustomResult.class).getMappedResults();