Wildfly 26中RESTEasy客户端调用POST时出现NullPointerException问题

问题根源 #

这个NullPointerException是Wildfly容器自带的RESTEasy版本与应用打包的RESTEasy 4.7.7版本冲突导致的类加载异常。Wildfly 26.1.3.Final默认集成的是RESTEasy 6.x系列版本，与4.x版本的API实现存在兼容性差异：当你通过ClientBuilder.newClient()创建客户端时，容器会优先加载自带的RESTEasy类，与应用内的旧版本类混合，最终引发反射实例化拦截器构造器时失败。

解决方案 #

方案1：排除应用中的RESTEasy依赖，使用Wildfly自带版本

修改构建脚本（Maven/Gradle），将所有RESTEasy相关依赖的作用域设为provided，让容器提供这些类：

Maven示例：

<dependency>
    <groupId>org.jboss.resteasy</groupId>
    <artifactId>resteasy-client</artifactId>
    <version>4.7.7.Final</version>
    <scope>provided</scope>
</dependency>
<dependency>
    <groupId>org.jboss.resteasy</groupId>
    <artifactId>resteasy-core</artifactId>
    <version>4.7.7.Final</version>
    <scope>provided</scope>
</dependency>
<!-- 其他RESTEasy相关依赖同理设置为provided -->

方案2：配置模块隔离，强制应用使用自身的RESTEasy版本

如果必须保留RESTEasy 4.7.7版本，可通过jboss-deployment-structure.xml隔离容器自带的RESTEasy模块：

在EAR包的META-INF目录下创建jboss-deployment-structure.xml，内容如下：

<jboss-deployment-structure>
    <deployment>
        <exclude-subsystems>
            <subsystem name="jaxrs" />
        </exclude-subsystems>
        <exclusions>
            <module name="javax.ws.rs.api" />
            <module name="org.jboss.resteasy.resteasy-jaxrs" />
            <module name="org.jboss.resteasy.resteasy-core" />
            <module name="org.jboss.resteasy.resteasy-client" />
        </exclusions>
        <local-last value="true" />
    </deployment>
</jboss-deployment-structure>

同时确保应用打包了完整的RESTEasy 4.7.7依赖，容器将优先加载应用内的版本。

方案3：升级RESTEasy版本至Wildfly兼容版本

Wildfly 26.1.3.Final兼容的RESTEasy版本为6.2.7.Final，将应用中的RESTEasy依赖版本升级至此，与容器自带版本保持一致，即可避免冲突。

验证步骤 #

1. 按上述方案修改后重新打包应用
2. 部署至Wildfly 26.1.3.Final并调用接口，确认NullPointerException是否消失

内容的提问来源于stack exchange，提问作者j-dimension