Spring Data MongoDB聚合查询复合ID返回null问题求助

这个问题其实是Spring Data MongoDB聚合框架的默认行为导致的——当你使用聚合查询时，复合ID的字段会被默认从_id嵌套结构里"扁平化"出来，而MappingMongoConverter只会识别嵌套在_id下的字段来映射到你的CompositeKey，所以就出现了ID为null的情况。

最直接的解决方案：保留_id嵌套结构 #

在聚合操作里显式通过project阶段指定保留_id的原始嵌套结构，这样转换器就能正确映射复合ID了。

修改你的测试代码，在聚合操作列表中添加project步骤：

List<AggregationOperation> aggOpList = new ArrayList<AggregationOperation>();
aggOpList.add(Aggregation.match(crit));
// 显式指定要保留的字段，包括嵌套的_id
aggOpList.add(Aggregation.project("_id", "param"));

这样聚合查询返回的文档结构就会和find查询一致：

{_id: {stringKey: "one", intKey: 1}, param: "param1"}

MappingMongoConverter就能正常将_id映射到你的CompositeKey属性了。

如果你的实体有大量字段，不想逐个列举，也可以用include方法简化：

aggOpList.add(Aggregation.project().include("_id").include("param"));

为什么find查询没问题？ #

find是直接返回MongoDB中的原始文档，_id本来就是嵌套的复合结构，转换器可以直接匹配字段映射；而聚合框架默认会对_id结构做处理（比如分组操作会把分组字段放入_id），即使只是简单的match聚合，它也会自动展开复合ID的字段，导致转换器无法识别这些字段属于ID属性。

备选方案：自定义读取转换器 #

如果你不想修改聚合操作，也可以自定义一个读取转换器，手动将扁平化的字段映射到复合ID：

1. 实现Converter接口 #

public class MyEntityConverter implements Converter<Document, MyEntity> {
    @Override
    public MyEntity convert(Document doc) {
        MyEntity entity = new MyEntity();
        // 从扁平化字段中提取复合ID信息
        String stringKey = doc.getString("stringKey");
        Integer intKey = doc.getInteger("intKey");
        if (stringKey != null && intKey != null) {
            entity.setId(new MyEntity.CompositeKey(stringKey, intKey));
        }
        // 映射其他字段
        entity.setParam(doc.getString("param"));
        return entity;
    }
}

2. 注册转换器到MongoTemplate #

MappingMongoConverter converter = new MappingMongoConverter(new DefaultDbRefResolver(factory), new MongoMappingContext());
converter.setCustomConversions(new CustomConversions(Collections.singletonList(new MyEntityConverter())));
MongoTemplate mongoTemplate = new MongoTemplate(factory, converter);

不过这种方案需要手动维护字段映射，不如第一种方案简洁，推荐优先使用保留_id结构的方式。

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