Jersey2.33构建Jersey客户端调用executorService报NoSuchMethodError
问题根因定位
NoSuchMethodError的核心触发逻辑是编译期代码引用的方法签名,和运行期类加载器实际加载到的Jar包中的方法签名完全不匹配,结合你提供的Jersey 2.33使用场景,报错的具体诱因可以拆解为三点:
- 版本方法定义变更:Jersey 2.26版本后,将原本定义在
JerseyClientBuilder类上的executorService(ExecutorService)实例方法,上移到了上层抽象基类中,方法返回值类型也同步调整为基类类型。如果运行期加载到的是2.26之前的低版本Jersey类,就会出现“类上找不到对应签名方法”的报错。 - 依赖版本冲突:你当前引用的
javax.ws.rs-api 2.1.1是匹配JAX-RS 2.1规范的版本,executorService方法是JAX-RS 2.1才新增的接口方法。如果传递依赖拉取到了低版本的javax.ws.rs-api 2.0(无此接口方法),或者版本错配的Jersey组件Jar,就会触发签名不匹配问题。 - 类加载优先级冲突:你代码中使用
@Resource注入了容器管理的ManagedExecutorService,说明服务运行在Weblogic、WildFly这类应用服务器上。这类容器通常会在公共类路径下内置低版本的Jersey实现Jar,类加载优先级高于项目自身WEB-INF/lib下的Jar包,最终出现“编译用项目新版Jar、运行加载容器老版Jar”的错位。
可落地的解决方案
- 全链路统一依赖版本
执行mvn dependency:tree命令排查所有传递依赖,将所有Jersey相关模块(jersey-client、jersey-container-servlet、jersey-media-json-jackson、jersey-apache-connector)的版本统一锁为2.33,对所有传递依赖引入的低版本Jersey、javax.ws.rs-apiJar,通过<exclusion>标签强制排除,避免跨版本混用。 - 调整代码的调用逻辑
- 不要直接基于
JerseyClientBuilder的具体类做链式方法调用,将构造的Builder对象统一用ClientBuilder接口承接,从编译层面避免方法签名匹配错位:ClientBuilder builder = new JerseyClientBuilder() .withConfig(configuration) .executorService(executorService); return builder; - 更稳妥的替代方案是直接将线程池配置写入
ClientConfig属性,完全绕开Builder层的方法签名匹配问题:configuration.property(ClientProperties.EXECUTOR_SERVICE, executorService);
- 不要直接基于
- 调整容器类加载策略
如果运行在应用服务器环境,需要在项目的容器专属配置文件中(如Weblogic的weblogic.xml、Tomcat的context.xml)配置类加载优先级,强制项目优先加载自身WEB-INF/lib下的类,不要优先使用容器公共路径下的内置Jersey类。
附带修正代码隐性问题
你当前的超时配置逻辑存在错误,ClientProperties.CONNECT_TIMEOUT、ClientProperties.READ_TIMEOUT属性的第二个入参需要传入具体的超时毫秒数值,你目前传入的是TimeUnit.MILLISECONDS枚举对象,会导致超时配置完全失效,需替换为实际的超时值,比如:
configuration.property(ClientProperties.CONNECT_TIMEOUT, 5000); configuration.property(ClientProperties.READ_TIMEOUT, 10000);
内容的提问来源于stack exchange,提问作者Vijay Bhaskar
相关产品推荐
相关产品推荐

