Spring Boot从2.4.13升级到2.5.14后Mongo聚合查询异常

问题原因 #

Spring Boot 2.5.x对应的Spring Data MongoDB版本升级后，聚合查询结果的映射逻辑变得更严格。在2.4.x版本中，当聚合结果里某个字段是数组（比如[]），而实体类对应字段为String类型时，框架会默认做隐式转换（例如转成空字符串）；但2.5.x版本取消了这种宽松的隐式转换，直接抛出类型不匹配的异常。

解决方案 #

方案1：修改实体类字段类型匹配聚合结果 #

如果聚合查询返回的该字段确实是数组结构，直接把实体类中对应字段的类型从String改成List<String>或者Object，从根源上解决类型不匹配问题。

方案2：注册自定义类型转换器 #

如果必须保持实体类字段为String类型，需要自定义Converter<ArrayList, String>并注册到Spring Data MongoDB的转换体系中：

1. 实现自定义转换器：

import org.springframework.core.convert.converter.Converter;
import org.springframework.data.convert.ReadingConverter;
import java.util.ArrayList;

@ReadingConverter // 标记为读取Mongo数据时的转换器
public class ArrayListToStringConverter implements Converter<ArrayList<?>, String> {
    @Override
    public String convert(ArrayList<?> source) {
        if (source == null || source.isEmpty()) {
            return ""; // 空数组转空字符串
        }
        // 按需自定义转换逻辑，比如用逗号拼接数组元素
        return String.join(",", source.stream().map(Object::toString).toList());
    }
}

2. 注册转换器到Mongo配置：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.mongodb.core.convert.MongoCustomConversions;
import java.util.List;

@Configuration
public class MongoConfig {
    @Bean
    public MongoCustomConversions mongoCustomConversions() {
        return new MongoCustomConversions(List.of(new ArrayListToStringConverter()));
    }
}

方案3：调整聚合查询语句 #

修改聚合管道，确保返回的字段类型和实体类匹配。比如如果原本聚合结果中该字段是数组，用$join、$first等操作符将其转为字符串类型。示例：

// 聚合管道中添加$project阶段，将tags数组转为字符串
{
    $project: {
        // 其他字段...
        tags: { $cond: { if: { $isEmpty: "$tags" }, then: "", else: { $join: { input: "$tags", separator: "," } } } }
    }
}

注意事项 #

• 优先选择方案1，类型匹配是最规范的做法，能避免后续版本升级再出现类似问题。
• 自定义转换器时要处理null和空数组的情况，防止空指针异常。
• 调整聚合查询时要熟悉MongoDB聚合操作符，确保转换逻辑符合业务需求。

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