Jersey 3.1.3 因升级依赖 jakarta.ws.rs-api 3.1.0（要求 Java 11，class 文件版本 55.0），已正式放弃对 JDK 8 的二进制兼容性，即使项目显式配置 source/target=1.8 也会在编译期报 bad class file: ... should be 52.0 错误。
jersey 3.1.3 因升级依赖 `jakarta.ws.rs-api 3.1.0`（要求 java 11，class 文件版本 55.0），已**正式放弃对 jdk 8 的二进制兼容性**，即使项目显式配置 `source/target=1.8` 也会在编译期报 `bad class file: ... should be 52.0` 错误。
Jersey 作为 JAX-RS 的官方参考实现，其版本演进严格遵循 Jakarta EE 规范节奏。自 Jersey 3.x 起，项目全面迁移到 Jakarta 命名空间（jakarta.* 替代 javax.*），并逐步提升 Java 基线要求。关键分水岭在于：
- ✅ Jersey 3.0.x 系列（如 3.0.11）：依赖
jakarta.ws.rs-api:3.0.0，该 API 编译于 Java 8（class 文件版本 52.0），完全兼容 JDK 8 运行时与编译目标； - ❌ Jersey 3.1.3：升级至
jakarta.ws.rs-api:3.1.0，其 官方规范文档 明确声明“Requires Java SE 11 or higher”，对应 class 文件版本为 55.0 —— 这直接导致 JDK 8 的javac在读取该类时触发UnsupportedClassVersionError，错误信息中should be 52.0即为 JDK 8 的预期版本号。
复现与验证方式
可通过以下命令快速验证依赖的 class 版本：
# 下载 jakarta.ws.rs-api-3.1.0.jar 后检查 Client.class javap -verbose -cp jakarta.ws.rs-api-3.1.0.jar jakarta.ws.rs.client.Client | grep "major version" # 输出：major version: 55 → 确认为 Java 11 编译
解决方案对比
| 方案 | 适用场景 | 操作要点 | 风险提示 |
|---|---|---|---|
| 降级 Jersey 至 3.0.11 | 项目必须坚守 JDK 8，且无需 Jakarta EE 10 新特性 | 修改 Maven 依赖：<version>3.0.11</version>，保持 jersey-client 及关联模块（如 jersey-hk2, jersey-media-json-binding）同属 3.0.x 小版本 |
兼容性最佳；但无法使用 Jersey 3.1+ 的新功能（如改进的异步客户端、增强的 OpenAPI 支持） |
| 升级 JDK 至 11+ | 项目具备升级条件，追求长期维护性 | 将构建与运行环境统一升级至 JDK 11 或更高（推荐 Eclipse Temurin 11/17 LTS）；同步检查 --add-opens 等 JVM 参数是否需调整 |
彻底规避 class 版本问题；需同步验证第三方库（如 Log4j 2.x、Hibernate 5.6+）及反射限制 |
| 强制排除并替换 API（不推荐） | 极端受限场景下的临时绕过 |
<exclusions><exclusion><groupid>jakarta.ws.rs</groupid><artifactid>jakarta.ws.rs-api</artifactid></exclusion></exclusions> + 手动引入 jakarta.ws.rs-api:3.0.0
|
违反 Jersey 3.1.3 的语义契约，可能导致运行时 NoSuchMethodError 或行为异常，生产环境严禁使用
|
重要注意事项
- Jersey 官方文档中 “targets Java 8” 的表述，指的是源码兼容性与最低开发要求，而非二进制运行时兼容性；实际依赖链的 class 版本由最深层传递依赖决定。
- Maven 的
<maven.compiler.source></maven.compiler.source>和<maven.compiler.target></maven.compiler.target>仅控制你自身代码的编译输出版本，无法降级已编译的第三方 class 文件（如jakarta.ws.rs-api-3.1.0.jar）。 - 若项目同时使用 Spring Boot，需注意：Spring Boot 3.x 已强制要求 JDK 17+，而 Spring Boot 2.7.x 是最后一个支持 JDK 8 的主线版本——Jersey 3.0.11 与 Spring Boot 2.7.x 组合是当前 JDK 8 生态中最稳定的企业级 REST 客户端方案。
综上，面对 jersey-client 3.1.3 与 JDK 8 的冲突，务实选择是锁定 Jersey 3.0.11。这并非技术倒退，而是对 Java 8 生命周期末期“确定性”的尊重——正如 JDK 8u391、Tomcat 8.5.99 等被广泛用于金融与政务系统的 LTS 基线一样，Jersey 3.0.x 系列正是该生态中 REST 客户端的可靠锚点。
