为何@JsonIgnore注解会影响JAXB的XML编组？

我有一个通用类，使用JAXB实现XML的编解码，同时用Jackson库实现JSON的序列化与反序列化。其中type字段标注了@XmlTransient（表示XML编组时需忽略该字段）和@JsonIgnore（表示JSON序列化时需忽略该字段）。但遇到问题：当同时添加这两个注解时，XML编组会生成<type>标签；仅保留@XmlTransient时则不会生成该标签。想了解为何来自不同库的@JsonIgnore会影响XML编组？

相关类代码 #

Parent.java #

@JsonTypeInfo(use = JsonTypeInfo.Id.NAME, visible = true, property = "type")
@JsonSubTypes({
  @JsonSubTypes.Type(value = Child.class, name = "Child")
})
@JsonInclude(Include.NON_NULL)
@Getter
@Setter
@NoArgsConstructor
@AllArgsConstructor
@XmlAccessorType(XmlAccessType.FIELD)
@XmlTransient
@Builder
public class Person implements Serializable {

  @XmlTransient
  @JsonIgnore
  private String type;

  private String name;
  private String age;
}

Child.java #

@XmlType(
    name = "Child",
    propOrder = {
      "name",
      "age",
      "nickname"
    },
    factoryClass = ObjectFactory.class,
    factoryMethod = "createPerson")
@JsonTypeInfo(
    use = JsonTypeInfo.Id.NAME,
    include = JsonTypeInfo.As.PROPERTY,
    visible = true,
    property = "type")
@JsonInclude(JsonInclude.Include.NON_NULL)
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
@NoArgsConstructor
@AllArgsConstructor
@XmlAccessorType(XmlAccessType.FIELD)
@XmlRootElement(name = "Child")
@JsonPropertyOrder({
  "type",
  "name",
  "age",
  "nickname"
})
public class Child extends Person implements XmlSupportExtension {
  private String nickname;
}

XmlSupportExtension.java #

@JsonTypeInfo(
    use = JsonTypeInfo.Id.NAME,
    include = JsonTypeInfo.As.PROPERTY,
    visible = true,
    property = "type")
@JsonSubTypes({
  @JsonSubTypes.Type(value = Child.class, name = "Child")
})
@JsonIgnoreProperties(ignoreUnknown = true)
@XmlSeeAlso({
  Child.class
})
public interface XmlSupportExtension {
  Object xmlSupport();
}

ObjectFactory.java #

import jakarta.xml.bind.annotation.XmlRegistry;

@XmlRegistry
public final class ObjectFactory {
  private ObjectFactory() {}

  // Returns Child
  public static Child createPerson() {
    return new Child();
  }
}

预期与实际XML结果 #

预期XML编组结果 #

<child>
 <name>Batman</name>
 <age>50</age>
 <nickname>Batman</nickname>
</child>

实际生成的XML #

<child>
 <name>Batman</name>
 <age>50</age>
 <nickname>Batman</nickname>
 <type>child</type>
</child>

原因分析与解决方案 #

原因 #

1. Jackson JAXB模块的干扰：如果项目引入了jackson-module-jaxb-annotations，该模块会在处理Jackson注解时间接影响JAXB的注解解析逻辑。@JsonIgnore的存在可能让JAXB错误识别字段属性，覆盖@XmlTransient的作用。
2. @JsonTypeInfo的visible属性冲突：Person和Child类中@JsonTypeInfo的visible = true配置，会让Jackson将type作为普通业务属性处理，即使加了@JsonIgnore，也会和JAXB的@XmlTransient产生冲突，导致JAXB无法正确忽略该字段。
3. 多层注解冗余：XmlSupportExtension接口上重复定义了@JsonTypeInfo，多层类型信息注解进一步混淆了JAXB对字段的识别逻辑。

解决方案 #

1. 调整注解位置：将Jackson注解（如@JsonIgnore）放在getter方法上，JAXB注解（如@XmlTransient）放在字段上，避免同位置注解冲突，让两个库各自处理对应位置的注解。
2. 修改@JsonTypeInfo的visible属性：将Person和Child类中@JsonTypeInfo的visible改为false，这样Jackson不会把type作为普通属性暴露，消除对JAXB的干扰。
3. 统一用Jackson XML模块：如果同时需要JSON和XML序列化，直接使用Jackson的XML模块（jackson-dataformat-xml），用@JacksonXmlIgnore替代@XmlTransient，让所有序列化逻辑由Jackson统一处理，避免跨库注解冲突。
4. 移除冗余注解：删除XmlSupportExtension接口上的@JsonTypeInfo注解，父类Person已定义类型信息，冗余注解只会增加冲突风险。

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