Spring Jackson JsonDeserialize在嵌套类第二层失效问题排查

1. 检查嵌套类的访问权限（最常见原因） #

如果PrizeGroup是非静态内部类（比如属于PrizeInfo的内部类），Jackson无法直接实例化它，会绕过字段上的@JsonDeserialize注解，使用默认的内部构造逻辑。

解决方法：

• 将PrizeGroup改为静态内部类：

  public class PrizeInfo {
      // ...其他字段
      private PrizeGroup prizeGroup;
  
      // 改为静态内部类
      public static class PrizeGroup {
          @JsonDeserialize(using = EnumDeserializer.class)
          private TargetEnum targetEnum;
          // ...其他字段
      }
  }
  

• 或者将PrizeGroup提取为独立的顶级类。

2. 验证自定义反序列化器的泛型/类型匹配 #

如果你的EnumDeserializer是针对特定枚举编写的（而非泛型），嵌套层级下Jackson无法识别它匹配PrizeGroup中的枚举类型，导致注解失效。

错误示例（非泛型反序列化器）： #

public class EnumDeserializer extends StdDeserializer<SomeEnum> {
    @Override
    public SomeEnum deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
        // 仅处理SomeEnum，无法处理PrizeGroup中的TargetEnum
        return SomeEnum.valueOf(p.getText().toUpperCase());
    }
}

正确实现（泛型支持）： #

public class GenericEnumDeserializer<T extends Enum<T>> extends StdDeserializer<T> {
    private final Class<T> enumClass;

    // 必须传入枚举类类型
    public GenericEnumDeserializer(Class<T> enumClass) {
        super(enumClass);
        this.enumClass = enumClass;
    }

    @Override
    public T deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
        String value = p.getText().trim();
        return Enum.valueOf(enumClass, value.toUpperCase());
        // 可添加自定义匹配逻辑（比如忽略下划线、映射别名等）
    }
}

使用泛型反序列化器： #

在PrizeGroup的枚举字段上指定反序列化器时，需要明确绑定枚举类型：

public class PrizeGroup {
    @JsonDeserialize(using = GenericEnumDeserializer.class)
    private TargetEnum targetEnum;

    // 为该枚举创建对应的Builder（Jackson需要通过Builder获取泛型类型）
    public static class TargetEnumBuilder extends GenericEnumDeserializer<TargetEnum> {
        public TargetEnumBuilder() {
            super(TargetEnum.class);
        }
    }
}

3. 检查注解冲突与位置 #

• 确保PrizeGroup的枚举字段没有@JsonIgnore、@JsonProperty(access = JsonProperty.Access.READ_ONLY)等冲突注解，这些会覆盖@JsonDeserialize的行为。
• 确认@JsonDeserialize注解是否放在了正确的位置：优先放在字段或setter方法上，如果放在getter上，Jackson默认的访问策略可能优先使用getter的配置，导致字段注解失效。
• 可以强制Jackson使用字段访问策略，在DTO类上添加：

  @JsonAutoDetect(fieldVisibility = JsonAutoDetect.Visibility.ANY, getterVisibility = JsonAutoDetect.Visibility.NONE)
  public class PrizeGroup {
      // ...字段
  }
  

4. 确认自定义反序列化器已注册到Spring的ObjectMapper #

如果你的反序列化器是手动创建的，但未注册到Spring容器的ObjectMapper中，Spring MVC/Jackson会使用默认的ObjectMapper，导致自定义反序列化器不生效。

注册方式：

@Configuration
public class JacksonConfig {
    @Bean
    public ObjectMapper objectMapper() {
        ObjectMapper mapper = new ObjectMapper();
        SimpleModule customModule = new SimpleModule();
        // 为PrizeGroup中的枚举注册反序列化器
        customModule.addDeserializer(TargetEnum.class, new GenericEnumDeserializer<>(TargetEnum.class));
        // 如果是所有枚举通用，可注册为Enum.class的反序列化器
        // customModule.addDeserializer(Enum.class, new GenericEnumDeserializer<>(...));
        mapper.registerModule(customModule);
        return mapper;
    }
}

5. 开启Jackson调试日志定位问题 #

如果以上方法都无效，开启Jackson的DEBUG日志，查看它选择的反序列化器类型，确认是否加载了你的自定义实现：

在application.properties中添加：

logging.level.com.fasterxml.jackson.databind=DEBUG

查看日志中类似如下的输出，确认反序列化器是否匹配：

DEBUG com.fasterxml.jackson.databind.deser.BeanDeserializerFactory - Found deserializer for type [class com.example.TargetEnum]: com.example.GenericEnumDeserializer@xxxxxx

6. 验证JSON数据结构与DTO匹配 #

确保传入的JSON数据结构与PrizeGroup的字段类型完全匹配，比如如果字段是单个TargetEnum，JSON不能是数组；如果是集合，JSON必须是数组结构。类型不匹配时，Jackson会跳过自定义反序列化器，使用默认逻辑。

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