Java17迁移时Jersey Client创建报错：JerseyClientBuilder非子类型

1. 彻底清理旧依赖（核心操作） #

• 检查项目依赖树，确保无Jersey 2.x（javax.ws.rs相关）依赖残留，比如jersey-client、jersey-core的2.x版本，这类旧依赖会和Jakarta版本的Jersey 3.x产生类冲突。
• 用依赖分析工具排查：Maven执行mvn dependency:tree，Gradle执行./gradlew dependencies，找到所有javax.ws.rs开头的依赖并排除，替换为jakarta.ws.rs对应包。

2. 确保Jersey Client依赖完整 #

Jersey 3.x需要完整的客户端依赖集，仅引入jersey-client可能导致实现类加载失败，需添加以下核心依赖：

Maven示例 #

<dependency>
    <groupId>org.glassfish.jersey.core</groupId>
    <artifactId>jersey-client</artifactId>
    <version>3.1.0</version>
</dependency>
<dependency>
    <groupId>org.glassfish.jersey.inject</groupId>
    <artifactId>jersey-hk2</artifactId>
    <version>3.1.0</version>
</dependency>
<dependency>
    <groupId>jakarta.ws.rs</groupId>
    <artifactId>jakarta.ws.rs-api</artifactId>
    <version>3.1.0</version>
</dependency>

Gradle示例 #

implementation 'org.glassfish.jersey.core:jersey-client:3.1.0'
implementation 'org.glassfish.jersey.inject:jersey-hk2:3.1.0'
implementation 'jakarta.ws.rs:jakarta.ws.rs-api:3.1.0'

Jersey 3.x依赖HK2作为默认注入器，缺失会导致ClientBuilder无法正确加载实现类。

3. 显式指定ClientBuilder实现（绕过SPI加载问题） #

如果SPI（服务提供者接口）加载因类加载器冲突失效（比如Spark类加载器隔离导致无法找到Jersey的SPI配置），直接实例化JerseyClientBuilder替代SPI查找：

import org.glassfish.jersey.client.JerseyClientBuilder;
import jakarta.ws.rs.client.Client;

// 替换原有的ClientBuilder.newClient()
Client client = new JerseyClientBuilder().build();

这种方式跳过SPI机制，直接使用Jersey实现类，避免类加载器导致的类型不匹配。

4. 处理Spark类加载器冲突 #

Spark的类加载器可能优先加载旧依赖，需在Spark配置中设置应用类加载器优先：

SparkConf conf = new SparkConf()
    .setAppName("YourApp")
    .setMaster("local[*]")
    // 让应用类加载器优先加载，避免Spark加载旧Jersey依赖
    .set("spark.driver.userClassPathFirst", "true")
    .set("spark.executor.userClassPathFirst", "true");

注意：集群环境使用该配置需谨慎，可能影响Spark自身依赖，但本地调试或依赖冲突明确时有效。

5. 验证Jakarta包替换彻底 #

确保所有代码中Jersey相关类均来自jakarta.ws.rs包：

• 替换import javax.ws.rs.client.Client;为import jakarta.ws.rs.client.Client;
• 替换@GET、@Path等注解的导入路径，全部改为jakarta.ws.rs.*。

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