Spring Data MongoDB标记接口属性反序列化问题求助

嘿，我之前也碰到过几乎一模一样的问题！在Spring 4.x + Spring Data MongoDB 1.x的组合里，当实体类的属性是标记接口类型、实际赋值是枚举实现类时，存的时候没问题，但读的时候就会因为类型匹配不上报错。下面给你一步步拆解解决方案：

问题到底出在哪？ #

简单说，Spring Data MongoDB默认会把枚举转成字符串（枚举的name值）存进库，但读的时候，因为你的属性是标记接口（比如EventType），框架根本不知道这个字符串该对应哪个具体的枚举实现类（比如OrderEventType），自然就抛出转换异常了。

核心解决方案：自定义类型转换器 #

我们得自己写转换器，告诉Spring Data MongoDB怎么在标记接口和数据库里的字符串之间互相转换。

第一步：先明确你的代码结构（假设是这样） #

先确认下你的标记接口、枚举和实体类大概是这个样子吧？

// 标记接口，只做类型标记，没有方法
public interface EventType {}

// 实现了标记接口的枚举类
public enum OrderEventType implements EventType {
    CREATED, CANCELLED, SHIPPED
}

// 需要持久化的实体类
public class MyEventOne {
    private String id;
    private EventType eventType; // 这里是标记接口类型

    // getter、setter就不写啦
}

第二步：写序列化转换器（把EventType转成字符串存库） #

这个转换器负责把枚举实例（因为实际赋值的是枚举）转成字符串，让MongoDB能存：

import org.springframework.core.convert.converter.Converter;
import org.springframework.data.convert.WritingConverter;

@WritingConverter // 告诉Spring这是往数据库写的时候用的转换器
public class EventTypeToStringConverter implements Converter<EventType, String> {
    @Override
    public String convert(EventType source) {
        // 因为source本质是枚举，直接取它的name就行
        return ((Enum<?>) source).name();
    }
}

第三步：写反序列化转换器（把字符串转回EventType） #

这里关键是要指定把字符串转成哪个枚举类。如果你的标记接口只有一个枚举实现，直接转就行；如果有多个，就得加判断逻辑（比如根据字符串前缀或者额外存储的类型字段）。先给你单枚举的版本：

import org.springframework.core.convert.converter.Converter;
import org.springframework.data.convert.ReadingConverter;

@ReadingConverter // 告诉Spring这是从数据库读的时候用的转换器
public class StringToEventTypeConverter implements Converter<String, EventType> {
    @Override
    public EventType convert(String source) {
        // 把数据库里的字符串转成对应的枚举实例
        return OrderEventType.valueOf(source);
    }

    // 要是有多个枚举实现EventType，比如还有PaymentEventType，就可以加判断：
    // public EventType convert(String source) {
    //     if (source.startsWith("ORDER_")) {
    //         return OrderEventType.valueOf(source.replace("ORDER_", ""));
    //     } else if (source.startsWith("PAYMENT_")) {
    //         return PaymentEventType.valueOf(source.replace("PAYMENT_", ""));
    //     }
    //     throw new IllegalArgumentException("Unknown event type: " + source);
    // }
}

第四步：把转换器注册到Spring里 #

最后得让Spring知道我们写了这两个转换器，不然没用。分XML配置和Java配置两种情况：

如果你用XML配置：

<!-- 配置Mongo映射转换器，添加自定义转换器 -->
<mongo:mapping-converter>
    <mongo:custom-converters>
        <mongo:converter ref="eventTypeToStringConverter"/>
        <mongo:converter ref="stringToEventTypeConverter"/>
    </mongo:custom-converters>
</mongo:mapping-converter>

<!-- 把转换器注册成Spring Bean -->
<bean id="eventTypeToStringConverter" class="com.yourpackage.EventTypeToStringConverter"/>
<bean id="stringToEventTypeConverter" class="com.yourpackage.StringToEventTypeConverter"/>

如果你用Java配置：

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

import java.util.Arrays;

@Configuration
public class MongoConfig {

    @Bean
    public MongoCustomConversions mongoCustomConversions() {
        // 把两个转换器放进MongoCustomConversions里
        return new MongoCustomConversions(Arrays.asList(
                new EventTypeToStringConverter(),
                new StringToEventTypeConverter()
        ));
    }
}

最后再提个小注意点 #

要是你的标记接口有多个枚举实现，最好在存数据的时候额外加个字段（比如eventTypeClass），存枚举的全类名，这样反序列化的时候直接根据这个字段反射创建实例，比写一堆判断逻辑更灵活。

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