使用Java MongoDB驱动序列化含枚举POJO时遇解码错误求助

这个错误的核心原因很明确：MongoDB的POJO Codec在处理枚举类型时，默认会尝试通过反射调用公共构造函数来实例化对象，但Java枚举的构造函数本身是私有的——枚举实例是预定义的常量，根本不允许外部通过构造函数创建新实例，这就直接导致了CodecConfigurationException。

下面给你三种可行的解决方案，按推荐程度排序：

方案1：直接使用MongoDB内置的EnumCodec #

MongoDB Java驱动本身提供了专门处理枚举的EnumCodec，不需要自己写自定义Codec，直接注册即可：

// 注册EnumCodec到CodecRegistry
CodecRegistry codecRegistry = CodecRegistries.fromRegistries(
    MongoClientSettings.getDefaultCodecRegistry(),
    CodecRegistries.fromCodecs(new EnumCodec<>(SimplePhaseEnumType.class))
);

// 配置MongoClient使用这个CodecRegistry
MongoClientSettings settings = MongoClientSettings.builder()
    .codecRegistry(codecRegistry)
    .build();

MongoClient mongoClient = MongoClients.create(settings);

这个方案最简单，利用驱动原生支持，避免重复造轮子。

方案2：自定义枚举Codec（适合需要自定义序列化逻辑的场景） #

如果你的枚举需要特殊的序列化规则（比如存储枚举的自定义值而非name），可以自己实现Codec接口：

public class SimplePhaseEnumTypeCodec implements Codec<SimplePhaseEnumType> {
    @Override
    public void encode(BsonWriter writer, SimplePhaseEnumType value, EncoderContext encoderContext) {
        // 这里可以自定义存储的内容，比如存储枚举的name()
        writer.writeString(value.name());
    }

    @Override
    public SimplePhaseEnumType decode(BsonReader reader, DecoderContext decoderContext) {
        // 读取MongoDB中的值，用valueOf获取枚举实例
        String enumName = reader.readString();
        return SimplePhaseEnumType.valueOf(enumName);
    }

    @Override
    public Class<SimplePhaseEnumType> getEncoderClass() {
        return SimplePhaseEnumType.class;
    }
}

然后按方案1的方式注册这个自定义Codec即可。

方案3：通过注解引导POJO Codec使用静态工厂方法 #

如果你不想单独注册Codec，可以在枚举类上添加注解，告诉POJO Codec使用静态工厂方法（比如valueOf）来实例化枚举：

public enum SimplePhaseEnumType {
    INIT, PROCESSING, COMPLETED;

    // 告诉POJO Codec用这个静态方法来创建枚举实例
    @BsonCreator
    public static SimplePhaseEnumType fromValue(@BsonProperty("value") String value) {
        // 这里可以根据实际存储的字段调整，比如如果存的是ordinal就用values()[ordinal]
        return valueOf(value);
    }
}

然后确保你的POJO CodecProvider已经注册了这个枚举类，这样驱动就会调用这个静态方法，而不是尝试找公共构造函数。

内容的提问来源于stack exchange，提问作者Jose Vicente Nunez