Jersey 3.1.3 不兼容 JDK 8：原因、验证与降级方案-java教程-PHP中文网

Jersey 3.1.3 不兼容 JDK 8：原因、验证与降级方案

Jersey 3.1.3 因依赖 Jakarta RESTful WS API 3.1.0（编译于 Java 11，class 版本 55.0），导致在 JDK 8 环境下出现 bad class file: ... version 55.0, should be 52.0 错误，官方虽宣称 Jersey 支持 JDK 8，但该版本实际已放弃 JDK 8 兼容性。

jersey 3.1.3 因依赖 jakarta restful ws api 3.1.0（编译于 java 11，class 版本 55.0），导致在 jdk 8 环境下出现 `bad class file: ... version 55.0, should be 52.0` 错误，官方虽宣称 jersey 支持 jdk 8，但该版本实际已放弃 jdk 8 兼容性。

Jersey 作为 JAX-RS 的官方参考实现，长期以对 Java 版本的稳健支持著称。然而，从 3.1.0 版本起，其生态发生了关键转向：为适配 Jakarta EE 10 规范，jakarta.ws.rs-api 依赖被升级至 3.1.0（此前 3.0.x 系列使用的是 3.0.0）。这一变更看似微小，实则具有破坏性——Jakarta RESTful Web Services 3.1 规范明确要求 最低 Java 运行环境为 Java 11（对应 class 文件主版本号 55.0），而 JDK 8 仅支持最高 52.0。

你在构建时遇到的错误正是该不兼容性的直接体现：

[ERROR] ... cannot access jakarta.ws.rs.client.Client
  bad class file: .../jakarta.ws.rs-api-3.1.0.jar(jakarta/ws/rs/client/Client.class)
    class file has wrong version 55.0, should be 52.0

即使你通过 Maven 配置了和为 1.8，也无法绕过底层 API 字节码的 JVM 版本限制——JVM 在加载类时会严格校验主版本号，55.0 类无法在 JDK 8 上解析。

✅ 验证方法（终端快速确认）：

# 查看 jar 中 class 的主版本号（需 JDK 8+ 环境）
javap -verbose -cp ~/.m2/repository/jakarta/ws/rs/jakarta.ws.rs-api/3.1.0/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（最稳妥）
该版本依赖 jakarta.ws.rs-api:3.0.0（编译于 Java 8，major version: 52），完全兼容 JDK 8：
```
<dependency><groupid>org.glassfish.jersey.core</groupid><artifactid>jersey-client</artifactid><version>3.0.11</version></dependency>
```
若必须用 Jersey 3.1.x，需升级 JDK 至 11+
注意：升级 JDK 后，还需同步检查项目中其他组件兼容性（如 Tomcat 8.5 仅支持 JDK 8，需升至 Tomcat 9+；Spring Framework 5.3+ 才 fully support JDK 11）。

（不推荐）强制排除并替换 API（高风险）

<dependency><groupid>org.glassfish.jersey.core</groupid><artifactid>jersey-client</artifactid><version>3.1.3</version><exclusions><exclusion><groupid>jakarta.ws.rs</groupid><artifactid>jakarta.ws.rs-api</artifactid></exclusion></exclusions></dependency><dependency><groupid>jakarta.ws.rs</groupid><artifactid>jakarta.ws.rs-api</artifactid><version>3.0.0</version><!-- 强制回退 --></dependency>

⚠️ 此方式存在运行时 NoSuchMethodError 风险（因 3.1.3 内部可能已使用 3.1.0 新增 API），仅作临时验证，禁止用于生产。

? 重要提醒：

Jersey 官方文档中 “supports Java 8” 的描述，在 3.1.x 分支中已不再准确，属文档滞后问题（GitHub Issue #5406 已证实）；
对于 SSM、老 Spring MVC 或遗留政务/金融系统（普遍锁定 JDK 8 + Tomcat 8.5），请严格将 Jersey 限定在 3.0.x 系列；
若项目正推进 AI 能力集成（如流式调用大模型 API），且受限于 JDK 8，建议优先选用 Apache HttpClient 4.5.x（原生 JDK 8 友好）或 OkHttp 3.14.x（最后一个 JDK 8 兼容主版本），而非强耦合 Jersey。

兼容性不是版本数字的游戏，而是字节码、规范演进与生产现实的精密对齐——在老系统上“让 AI 开口说话”，第一步永远是：先确保你的 HTTP 客户端能稳稳地发出第一个请求。