Spring Boot 3升级后javax.ws.rs.core.UriBuilder相关异常求助

为什么UriBuilder会消失？ #

Spring Boot 3.0.x 基于 Jakarta EE 9+ 构建，而 Jakarta EE 已将原 Java EE 中的 javax.* 命名空间全部迁移到 jakarta.* 下。javax.ws.rs.core.UriBuilder 属于 Java EE 的 JAX-RS API，Spring Boot 3 的默认依赖栈不再包含任何 javax.ws.rs 相关类，因此升级后会出现 ClassNotFoundException。

解决步骤 #

1. 替换JAX-RS依赖为Jakarta版本 #

移除原有的 javax.ws.rs:javax.ws.rs-api 依赖，改用 Jakarta EE 对应的兼容版本：

implementation 'jakarta.ws.rs:jakarta.ws.rs-api:3.1.0'

2. 升级Jira Rest Client到支持Jakarta的版本 #

旧版本的 Jira Rest Client（如5.x及以下）依赖 javax.ws.rs，需要升级到适配 Jakarta EE 的版本。Atlassian 已发布支持 Jakarta 的 Jira RC 版本，例如：

implementation 'com.atlassian.jira:jira-rest-java-client-core:6.20.0'

该版本已将内部依赖从 javax.ws.rs 迁移到 jakarta.ws.rs。

3. 排除冲突的遗留依赖 #

若升级后仍存在依赖冲突，检查依赖树并排除旧的 javax.ws.rs 依赖。例如在 Jira RC 的依赖声明中添加排除规则：

implementation('com.atlassian.jira:jira-rest-java-client-core:6.20.0') {
    exclude group: 'javax.ws.rs', module: 'javax.ws.rs-api'
}

4. 清理并重新构建 #

执行以下命令彻底清理缓存并重新构建项目：

./gradlew clean build --refresh-dependencies

关于LinkageError的说明 #

你遇到的 LinkageError 是因为类加载器同时加载了 javax.ws.rs.ext.RuntimeDelegate 和 jakarta.ws.rs.ext.RuntimeDelegate，或者同一个类被不同类加载器加载导致类型转换异常。替换为全 Jakarta 栈的依赖后，所有相关类会统一使用 jakarta.* 命名空间，该问题将自动解决。

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