升级Wildfly至19+后CharacterEscapeHandler属性类型不匹配异常如何解决

问题根因 #

这个报错本质是类加载器冲突：Wildfly 19及更高版本自带的JAXB实现由容器类加载器加载，你应用中打包的JAXB依赖由应用类加载器加载，两个类加载器加载的com.sun.xml.bind.marshaller.CharacterEscapeHandler接口虽然全限定名完全相同，但在JVM中属于不同类型，因此你实现的接口和Marshaller要求的接口不匹配，才会抛出类型不符的异常。

可行解决方案 #

方案1：优先使用容器自带JAXB（推荐，适配性最高） #

1. 修改pom.xml中所有JAXB相关依赖的scope为provided，避免重复打包依赖进入应用：

<dependency>
 <groupId>javax.xml.bind</groupId>
 <artifactId>jaxb-api</artifactId>
 <version>2.2.12</version>
 <scope>provided</scope>
</dependency>
<dependency>
 <groupId>com.sun.xml.bind</groupId>
 <artifactId>jaxb-impl</artifactId>
 <version>2.2.11</version>
 <scope>provided</scope>
</dependency>
<dependency>
 <groupId>com.sun.xml.bind</groupId>
 <artifactId>jaxb-core</artifactId>
 <version>2.2.11</version>
 <scope>provided</scope>
</dependency>
<dependency>
 <groupId>com.sun.xml.bind</groupId>
 <artifactId>jaxb-xjc</artifactId>
 <version>2.2.11</version>
 <scope>provided</scope>
</dependency>

2. 在jboss-deployment-structure.xml中显式引入容器JAXB模块依赖，确保应用代码和容器使用同一个JAXB类加载上下文：

<jboss-deployment-structure>
    <deployment>
        <dependencies>
            <module name="javax.xml.bind.api" export="true"/>
            <module name="com.sun.xml.bind" export="true"/>
        </dependencies>
    </deployment>
</jboss-deployment-structure>

3. 删除此前添加的jaxb.properties文件、-Djavax.xml.bind.context.factory启动参数，避免覆盖容器默认配置。

方案2：完全使用自定义版本JAXB（适合需要固定JAXB版本的场景） #

如果你必须使用应用指定的JAXB版本，需要完全屏蔽容器自带的JAXB实现：

1. 在jboss-deployment-structure.xml中排除所有容器自带的JAXB相关模块：

<jboss-deployment-structure>
    <deployment>
        <exclusions>
            <module name="javax.xml.bind.api"/>
            <module name="com.sun.xml.bind"/>
            <module name="javax.xml.bind.impl"/>
            <module name="org.glassfish.jaxb"/>
        </exclusions>
    </deployment>
</jboss-deployment-structure>

2. 保持pom.xml中所有JAXB依赖的scope为默认compile，确保所有JAXB相关类都打包进应用发布包，由应用类加载器统一加载。

验证方式 #

修改完成后可以添加一行调试代码，确认接口和实现类使用同一个类加载器：

System.out.println("CharacterEscapeHandler类加载器：" + CharacterEscapeHandler.class.getClassLoader());
System.out.println("MarshallerImpl类加载器：" + com.sun.xml.bind.v2.runtime.MarshallerImpl.class.getClassLoader());

两者输出一致则说明类加载冲突已解决。

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