Jackson XML反序列化SOAP响应中布尔值的解析异常

本次报错的核心触发点是Interchange类的属性内省失败，和布尔类型本身的反序列化逻辑无关，完整触发逻辑链：

• 类中针对isTest字段定义了两个重载的同名setter，分别接收Boolean和String类型入参，触发Jackson的Bean属性识别歧义
• 歧义场景下Jackson会直接将isTest字段从可映射属性列表中移除，导致XML解析到<isTest>false</isTest>节点时，找不到对应的内部字段映射关系
• Jackson默认逻辑会尝试将未识别节点的文本值作为构造入参，尝试创建当前正在解析的Interchange类实例，因为没有匹配单String入参的构造器，最终抛出找不到构造器的异常

• 移除冗余的重载setter
  • 删除非标准的public void setIsTest(String isTest)方法，Jackson原生支持将XML节点中"true"/"false"的文本内容反序列化为Boolean类型，不需要额外针对String类型编写重载setter
  • 同名不同参的重载setter是JavaBean内省的高频问题源，Jackson在遇到多类型同属性setter时，大概率因为类型歧义跳过整个字段的映射
• 简化isTest字段的注解配置
  • 移除不必要的自定义序列化/反序列化器注解（@JsonSerialize、@JsonDeserialize），如果没有特殊的布尔值解析规则（比如需要解析"0/1"、"yes/no"这类非标准值），Jackson默认的布尔反序列化逻辑完全可以覆盖当前场景
  • 给字段明确指定@JacksonXmlProperty(localName = "isTest")，消除XML标签名和Java字段名的推导歧义
• 统一JavaBean命名规范
  • 布尔字段的getter、setter需和字段名保持一致的属性推导规则，避免出现命名错配
  • 修正后的isTest字段参考写法：

    @JacksonXmlProperty(localName = "isTest")
    private Boolean isTest;
    
    public Boolean getIsTest() {
        return isTest;
    }
    
    public void setIsTest(Boolean isTest) {
        this.isTest = isTest;
    }
    

• 补充Mapper层的容错配置
  • 增加xmlMapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false)配置，遇到未识别的XML节点时不直接抛出解析异常，方便定位真实的映射错位问题（注意：该配置仅为兜底，不能替代正确的字段映射关系）
  • 确认MapperFeature.ACCEPT_CASE_INSENSITIVE_VALUES仅作用于节点值的大小写匹配，不会影响XML标签名的识别，不要混淆配置的作用范围

• 不需要为标准布尔值编写自定义反序列化器，Jackson原生的BooleanDeserializer本身就支持解析"true"/"false"字符串，自定义配置写得不对反而会触发反序列化链路异常
• 不要在POJO类中保留多个无标识的构造器同时被Jackson识别，必要时给主要构造器加上@JsonCreator注解，避免Jackson错选构造器触发实例化异常

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