MongoDB Spring Boot JPA聚合查询_id反序列化异常求助

问题原因 #

你的聚合查询在$unwind后，Spring Data MongoDB默认将allEventsOfUser._id解析成了包含timestamp和date的Date对象，而非字符串格式的ObjectId，导致无法匹配实体类中String类型的_id字段。

解决方案 #

方法1：修改聚合管道，明确转换_id为字符串 #

在聚合管道中添加$replaceRoot将嵌套的allEventsOfUser转为根文档，再通过$project用$toString操作符把ObjectId格式的_id转换成字符串，确保返回结构与实体类匹配。

调整后的代码：

@Aggregation(pipeline = {
    "{'$match': {'userId': '?0'}}",
    "{'$unwind': {'path': '$allEventsOfUser'}}",
    "{'$match': {'allEventsOfUser.date': {'$gte': ?1, '$lte': ?2}}}",
    "{'$replaceRoot': {'newRoot': '$allEventsOfUser'}}",
    "{'$project': {'_id': {'$toString': '$_id'}, 'date': 1, /* 这里添加你需要保留的其他字段 */}}"
})
List<EventItem> findByUserIdAndDateRange(String name, Date dateStart, Date dateEnd);

• $replaceRoot：把allEventsOfUser的内容提升为根文档，让返回结果结构和EventItem一致
• $toString: '$_id'：将MongoDB的ObjectId类型转为字符串，匹配实体类中String类型的_id字段

方法2：自定义Mongo类型转换器 #

如果不想修改聚合管道，可以通过自定义转换器让Spring Data自动将ObjectId转为String：

1. 创建转换器类：

import org.bson.types.ObjectId;
import org.springframework.core.convert.converter.Converter;
import org.springframework.data.convert.ReadingConverter;

@ReadingConverter
public class ObjectIdToStringConverter implements Converter<ObjectId, String> {
    @Override
    public String convert(ObjectId source) {
        return source.toHexString();
    }
}

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 ObjectIdToStringConverter()));
    }
}

这样Spring Data在读取ObjectId类型的字段时，会自动转为String，无需修改聚合管道。

注意事项 #

• 之前尝试的@JsonIgnore无效，因为问题出在MongoDB查询结果到实体类的映射阶段，而非JSON序列化阶段，所以忽略字段不能解决格式转换问题。
• 确保聚合管道中保留EventItem实体类需要的所有字段，避免映射时丢失数据。

内容的提问来源于stack exchange，提问作者frank sinatra