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 配置了 <source></source> 和 <target></target> 为 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 客户端能稳稳地发出第一个请求。
