GlassFish JAXB 4.x迁移：javax注解失效，求非修改注解的解决方案

核心原因 #

JAXB 4.x属于Jakarta EE 9+生态，完全迁移到jakarta.xml.bind.annotation命名空间，不再识别旧的javax.xml.bind.annotation注解。你的共享库使用旧注解，导致JAXB无法读取类的XML命名空间配置，触发类型名重复错误。

可行替代方案 #

方案1：使用外部绑定文件覆盖配置 #

无需修改共享库代码，通过JAXB外部绑定文件指定类的XML类型名和命名空间，让JAXB优先使用外部配置：

1. 创建绑定文件（例如jaxb-bindings.xml），为两个SomeType类分别指定唯一的命名空间和类型名：

<jaxb:bindings xmlns:jaxb="https://jakarta.ee/xml/ns/jaxb" version="3.0">
    <!-- 为第一个SomeType类配置（替换为实际全限定类名） -->
    <jaxb:bindings node="class[fully-qualified-name='com.first.namespace.SomeType']">
        <jaxb:class name="SomeTypeFirst" namespace="http://your.first.namespace"/>
    </jaxb:bindings>
    <!-- 为第二个SomeType类配置（替换为实际全限定类名） -->
    <jaxb:bindings node="class[fully-qualified-name='com.second.namespace.SomeType']">
        <jaxb:class name="SomeTypeSecond" namespace="http://your.second.namespace"/>
    </jaxb:bindings>
</jaxb:bindings>

2. 创建JAXBContext时加载该绑定文件：

Map<String, Object> config = new HashMap<>();
config.put(JAXBContext.JAXB_BINDING_LOCATION, "jaxb-bindings.xml");

MyClass instance = JAXBContext.newInstance(MyClass.class, config)
                               .createUnmarshaller()
                               .unmarshal(new StreamSource(
                                   getClass().getClassLoader().getResourceAsStream("myfile.xml")
                               ), MyClass.class)
                               .getValue();

方案2：自定义注解阅读器兼容javax注解 #

实现自定义AnnotationReader，让JAXB 4.x能够读取旧的javax.xml.bind.annotation.XmlType注解并转换为Jakarta版本的注解信息：

1. 实现兼容的注解阅读器：

import jakarta.xml.bind.annotation.XmlType;
import org.glassfish.jaxb.core.annotation.AnnotationReaderImpl;
import org.glassfish.jaxb.core.api.Locatable;

import java.lang.annotation.Annotation;

public class JavaxAnnotationAdapter extends AnnotationReaderImpl {
    @Override
    public XmlType getClassAnnotation(XmlType clazz, Class<?> target, Locatable src) {
        // 先尝试读取Jakarta注解
        XmlType jakartaAnn = super.getClassAnnotation(clazz, target, src);
        if (jakartaAnn != null) {
            return jakartaAnn;
        }
        // 读取旧的javax注解并转换
        javax.xml.bind.annotation.XmlType javaxAnn = target.getAnnotation(javax.xml.bind.annotation.XmlType.class);
        if (javaxAnn == null) {
            return null;
        }
        // 返回模拟的Jakarta XmlType注解
        return new XmlType() {
            @Override
            public String name() { return javaxAnn.name(); }
            @Override
            public String namespace() { return javaxAnn.namespace(); }
            @Override
            public String[] propOrder() { return javaxAnn.propOrder(); }
            @Override
            public Class<?>[] factoryClass() { return javaxAnn.factoryClass(); }
            @Override
            public String factoryMethod() { return javaxAnn.factoryMethod(); }
            @Override
            public Class<? extends Annotation> annotationType() { return XmlType.class; }
        };
    }
}

2. 创建JAXBContext时指定该阅读器：

Map<String, Object> props = new HashMap<>();
props.put("org.glassfish.jaxb.core.annotation.AnnotationReader", new JavaxAnnotationAdapter());

MyClass instance = JAXBContext.newInstance(MyClass.class, props)
                               .createUnmarshaller()
                               .unmarshal(new StreamSource(
                                   getClass().getClassLoader().getResourceAsStream("myfile.xml")
                               ), MyClass.class)
                               .getValue();

注意事项 #

• 方案1更稳定，无需编写自定义代码，适合大多数场景；
• 方案2依赖JAXB内部API，后续版本可能存在兼容性风险；
• 若共享库后续有更新计划，仍建议逐步迁移到Jakarta注解，这是长期的最优解决方案。

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