Jackson自定义Map反序列化报错：找不到(Map)Key反序列化器

问题梳理 #

你自定义了继承HashMap的泛型类ClientParams<P extends Param>，其中P是实现Param接口的枚举，遇到以下反序列化问题：

• 场景1（目标实现）：反序列化ClientParams<P>时抛出Cannot find a (Map) Key deserializer异常
• 场景2：直接反序列化ClientParams<FirstParams>时提示无默认构造器，但该类可正常实例化
• 场景3：反序列化HashMap<FirstParams, Object>正常，但业务要求必须使用独立的ClientParams<P>类

解决方案 #

1. 修复「Cannot find a (Map) Key deserializer」异常

Jackson默认无法识别自定义枚举接口作为Map键的反序列化规则，需要手动为Param接口注册键反序列化器：

public class ParamKeyDeserializer extends KeyDeserializer {
    @Override
    public Object deserializeKey(String key, DeserializationContext ctxt) throws IOException {
        // 获取目标枚举类型，将字符串键转换为对应枚举实例
        Class<?> keyType = ctxt.getContextualType().getKeyType().getRawClass();
        if (Enum.class.isAssignableFrom(keyType)) {
            return Enum.valueOf((Class<? extends Enum>) keyType, key);
        }
        throw new IOException("无法解析Param类型的键: " + key);
    }
}

然后通过Jackson的Module注册该反序列化器：

SimpleModule module = new SimpleModule();
module.addKeyDeserializer(Param.class, new ParamKeyDeserializer());
ObjectMapper mapper = new ObjectMapper();
mapper.registerModule(module);

2. 修复无默认构造器问题

尽管你能实例化ClientParams，但Jackson反序列化泛型子类时，要求类具备可见的无参构造器。如果你的ClientParams只有带参构造器，需补充无参构造器：

public class ClientParams<P extends Param> extends HashMap<P, Object> {
    // 新增无参构造器
    public ClientParams() {
        super();
    }

    // 保留原有自定义构造器（如果有）
    public ClientParams(int initialCapacity) {
        super(initialCapacity);
    }
}

如果不想暴露无参构造器，也可以用@JsonCreator指定Jackson使用现有构造器，但需要JSON数据中包含对应参数，这种方式不如直接添加无参构造器简便。

3. 整合适配场景1

将上述配置结合后，即可正常反序列化ClientParams<P>：

// 初始化配置好的ObjectMapper
SimpleModule module = new SimpleModule();
module.addKeyDeserializer(Param.class, new ParamKeyDeserializer());
ObjectMapper mapper = new ObjectMapper();
mapper.registerModule(module);

// 反序列化示例
String json = "{\"PARAM1\":\"value1\",\"PARAM2\":123}";
ClientParams<FirstParams> params = mapper.readValue(json, new TypeReference<ClientParams<FirstParams>>() {});

注意：如果Param接口的枚举实现类用了自定义字符串映射（而非枚举名作为JSON键），需要在ParamKeyDeserializer中调整解析逻辑，比如调用枚举的自定义解析方法。

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