如何让Jackson自定义键序列化器仅对Class类型的Map键生效

你遇到的报错是因为Jackson中@JsonSerialize(keyUsing = ClassSerializer.class)标注在Map类型字段上时，指定的键序列化器会作用于该Map嵌套结构下所有层级的Map键，而非仅作用于顶层Map的Class类型键，才会导致内层Map的String键也被传入ClassSerializer触发类型转换异常。

方案1：全局注册类型匹配的键序列化器（推荐） #

这是最符合Jackson设计规范的方案，无需修改字段原有注解，Jackson会自动根据键的类型匹配对应序列化器：

1. 保留你原有ClassSerializer的实现
2. 将该序列化器注册到ObjectMapper的自定义模块中，指定仅处理Class类型的键：

SimpleModule classKeySerializationModule = new SimpleModule();
classKeySerializationModule.addKeySerializer(Class.class, new ClassSerializer());

ObjectMapper objectMapper = new ObjectMapper();
objectMapper.registerModule(classKeySerializationModule);

3. 删除原有字段上的@JsonSerialize(keyUsing = ClassSerializer.class)注解即可。
   此时Jackson会自动识别顶层Map的Class类型键使用你的自定义序列化器，内层Map的String类型键走默认序列化逻辑，不会出现冲突。

方案2：改造现有序列化器兼容多类型键 #

如果不想全局配置，也不想修改现有代码结构，可直接调整ClassSerializer的实现，增加类型判断逻辑，非Class类型的键走默认序列化：

public final class ClassSerializer extends JsonSerializer<Object> {
    // 引入Jackson默认键序列化器处理非Class类型的键
    private final StdKeySerializer defaultKeySerializer = new StdKeySerializer();

    @Override
    public void serialize(Object value, JsonGenerator gen, SerializerProvider serializers) throws IOException {
        if (value instanceof Class<?>) {
            gen.writeFieldName(((Class<?>) value).getSimpleName());
            return;
        }
        // 其他类型键委托给默认序列化器处理
        defaultKeySerializer.serialize(value, gen, serializers);
    }
}

修改后原有字段的注解无需调整，即可兼容嵌套Map的String键场景。

方案3：自定义顶层Map类型隔离序列化规则 #

你也可以把顶层的Map<Class<? extends Something>, Map<String, ? super Something>>封装为一个独立的自定义类，给该自定义类单独实现序列化逻辑，完全控制每一层的序列化规则，适合有更复杂定制需求的场景。

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