本文介绍在 maven 多 jdk 兼容构建中，如何精准控制 `jakarta.xml.bind-api` 依赖的引入：jdk 8 下完全排除（因其已内置），jdk 11+ 下显式声明，避免重复打包与运行时冲突。
在构建跨 JDK 版本（如同时支持 JDK 8 和 JDK 11+）的 Maven 项目时，jakarta.xml.bind-api 是一个典型“版本敏感依赖”：它在 JDK 8 中作为标准 API 内置（即 javax.xml.bind.*），自 JDK 9 起被模块化移除，并于 Jakarta EE 9 迁移为 jakarta.xml.bind.*。因此：
- ✅ JDK 8 构建时：不应引入 jakarta.xml.bind-api，否则会与 JDK 自带的 javax.xml.bind 类发生类路径冲突（尤其在传统 JEE 容器中易报 ClassCastException 或 NoClassDefFoundError）；
- ✅ JDK 11+ 构建时：必须显式提供该依赖（通常搭配 jaxb-runtime），否则编译或运行时将缺失 JAXB API。
Maven 原生不支持“按 JDK 版本动态 exclude 传递依赖”，maven-compiler-plugin 的
✅ 正确方案：全局排除 + 条件化声明
采用“先彻底排除，再按需恢复”的策略，通过 Maven Profile 实现 JDK 版本感知：
1. 全局排除所有来源的 jakarta.xml.bind-api
在
<dependencies>
<!-- 排除所有传递引入的 jakarta.xml.bind-api -->
<dependency>
<groupId>org.apache.cxf</groupId>
<artifactId>cxf-core</artifactId>
<version>3.5.3</version>
<exclusions>
<exclusion>
<groupId>jakarta.xml.bind</groupId>
<artifactId>jakarta.xml.bind-api</artifactId>
</exclusion>
<exclusion>
<groupId>org.glassfish.jaxb</groupId>
<artifactId>jaxb-runtime</artifactId>
</exclusion>
</exclusions>
</dependency>
</dependencies>⚠️ 注意：若依赖链较深（如 cxf-core → jaxb-runtime → jakarta.xml.bind-api），建议对最上游依赖（如 cxf-core）做 exclusion，而非逐层排除，更简洁可靠。
2. 仅在 JDK 11+ 环境中激活 Profile 声明依赖
利用 Maven 的 JDK 激活机制，定义一个仅在 JDK ≥ 11 时生效的 Profile：
<profiles>
<profile>
<id>jdk11-plus</id>
<activation>
<jdk>[11,)</jdk> <!-- 表示 JDK 11 及以上版本 -->
</activation>
<dependencies>
<!-- JDK 11+ 环境下显式引入必要绑定 -->
<dependency>
<groupId>jakarta.xml.bind</groupId>
<artifactId>jakarta.xml.bind-api</artifactId>
<version>4.0.0</version>
</dependency>
<dependency>
<groupId>org.glassfish.jaxb</groupId>
<artifactId>jaxb-runtime</artifactId>
<version>4.0.3</version> <!-- 推荐使用与 API 版本匹配的 runtime -->
</dependency>
</dependencies>
</profile>
</profiles>✅ 效果验证：
- 使用 JAVA_HOME=/path/to/jdk8 mvn clean package：Profile 不激活 → jakarta.xml.bind-api 完全不存在 → 无冲突；
- 使用 JAVA_HOME=/path/to/jdk17 mvn clean package：Profile 激活 → 依赖被注入 → JAXB 功能完整可用。
? 补充说明与最佳实践
- 避免混用 javax 与 jakarta 包：确保项目代码已迁移到 jakarta.xml.bind.*（JAXB 3.0+），否则 JDK 11+ 下即使引入依赖也无法工作；
-
检查 maven-enforcer-plugin：可添加规则强制禁止 jakarta.xml.bind-api 在 JDK 8 构建中出现：
<plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-enforcer-plugin</artifactId> <executions> <execution> <id>ban-jakarta-bind-on-jdk8</id> <phase>validate</phase> <configuration> <rules> <bannedDependencies> <excludes> <exclude>jakarta.xml.bind:jakarta.xml.bind-api</exclude> </excludes> <message>Jakarta XML Bind is forbidden on JDK 8 (already provided by JVM).</message> </bannedDependencies> </rules> </configuration> <goals><goal>enforce</goal></goals> </execution> </executions> </plugin> - CI/CD 建议：在流水线中分别用 openjdk:8-jdk 和 openjdk:17-jdk 执行构建，双重验证 Profile 行为正确性。
通过此方案，你实现了真正语义清晰、可维护性强的 JDK 版本条件依赖管理——既规避了 JDK 8 的类冲突风险，又保障了高版本 JDK 的功能完整性。
