Spring Boot 3升级Jersey Client遇ClassCastException问题求助

错误原因分析 #

你遇到的LinkageError本质是javax与Jakarta EE API的类路径冲突：Spring Boot 3全面切换到Jakarta EE标准（包路径从javax.*改为jakarta.*），但项目中仍存在javax.javaee-api依赖，导致类加载器尝试加载旧的javax.ws.rs.client.ClientBuilder，而你升级的Jersey Client 3.x已经使用jakarta.ws.rs.client.ClientBuilder，两者无法兼容。

解决方案 #

1. 排查并排除旧的javax依赖

首先定位javax.javaee-api的引入来源，执行Gradle命令：

./gradlew dependencyInsight --dependency javax.javaee-api

找到来源后，在build.gradle中全局排除该依赖：

configurations.all {
    exclude group: 'javax.javaee-api', module: 'javaee-api'
}

或者针对具体依赖精准排除：

implementation('问题依赖的groupId:artifactId:版本') {
    exclude group: 'javax.javaee-api', module: 'javaee-api'
}

2. 确保项目使用Jakarta EE API

Spring Boot 3默认已引入Jakarta EE相关API，若需显式声明可添加：

implementation 'jakarta.platform:jakarta.jakartaee-api:10.0.0'

3. 升级依赖到Jakarta兼容版本

找到仍使用javax的依赖，查询Maven仓库是否有支持Jakarta的新版本（通常版本号升级至3.x及以上），直接替换旧版本，这是最彻底的解决方式，可避免后续潜在冲突。

4. 类加载器隔离（极端场景）

若无法找到依赖的Jakarta版本，可尝试用Gradle Shadow插件将冲突依赖打包到独立类加载器中，但该方式复杂度高、维护成本大，仅作为最后手段。

关于强制依赖使用Jakarta包的可行性 #

旧依赖的字节码中硬编码了javax.*的包路径，无法通过配置强制它加载jakarta.*下的类。除非通过ASM等字节码修改工具重写依赖的类路径，但这种做法风险高，不推荐在生产环境使用。优先选择升级依赖或排除旧javax API的方案。

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