TomEE中部署含RestEasy客户端的REST服务时出现部署错误

这个错误的核心原因是：TomEE默认使用CXF作为JAX-RS服务端实现，而你引入的RestEasy依赖中包含了仅适用于客户端的Provider类，TomEE的CXF扫描器会尝试将这些客户端Provider当作服务端Provider加载，从而触发“不是SERVER provider”的检查失败。

下面是几个经过验证的解决方案，按推荐程度排序：

方案1：精简RestEasy依赖，只引入客户端相关模块 #

不要直接引入完整的resteasy-jaxrs包（它包含服务端和客户端的所有代码），只选择RestEasy客户端专用的依赖，这样就能避免服务端Provider被打包到你的应用中。

比如Maven依赖配置：

<dependencies>
    <!-- RestEasy核心客户端 -->
    <dependency>
        <groupId>org.jboss.resteasy</groupId>
        <artifactId>resteasy-client</artifactId>
        <version>3.5.1.Final</version>
    </dependency>
    <!-- 如果需要JSON序列化支持，添加对应的Provider -->
    <dependency>
        <groupId>org.jboss.resteasy</groupId>
        <artifactId>resteasy-jackson2-provider</artifactId>
        <version>3.5.1.Final</version>
    </dependency>
    <!-- 注：RestEasy客户端会自动处理表单编码，无需额外引入服务端的FormUrlEncodedProvider -->
</dependencies>

这个方案从根源上解决了问题，因为服务端Provider根本不会出现在你的应用包中，TomEE也就不会扫描到它。

方案2：配置TomEE排除特定的客户端Provider #

如果你无法精简依赖（比如项目中确实需要某些服务端模块），可以通过TomEE的配置参数，告诉它跳过对FormUrlEncodedProvider的加载检查。

方式A：通过web.xml配置 #

在你的WEB-INF/web.xml中添加以下上下文参数：

<context-param>
    <param-name>openejb.jaxrs.providers.exclude</param-name>
    <param-value>org.jboss.resteasy.plugins.providers.FormUrlEncodedProvider</param-value>
</context-param>

方式B：通过MicroProfile配置（如果使用TomEE Plus的MicroProfile支持） #

在src/main/resources/META-INF/microprofile-config.properties中添加：

openejb.jaxrs.providers.exclude = org.jboss.resteasy.plugins.providers.FormUrlEncodedProvider

这个参数会让TomEE的JAX-RS扫描器忽略指定的Provider类，避免触发合法性检查。

方案3：类加载器隔离（进阶） #

如果上述方案都不适用，可以尝试将RestEasy的依赖放在WEB-INF/lib，并通过TomEE的类加载器配置，让应用的类加载器优先加载RestEasy的客户端类，而不让TomEE的CXF扫描到这些Provider。不过这个方案配置较复杂，仅推荐作为最后手段。

验证步骤 #

无论采用哪个方案，部署后都需要验证：

1. TomEE启动时不再抛出IllegalArgumentException
2. 你的RestEasy客户端代码能正常发起请求并处理响应

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