JDK 版本适配 Jakarta XML Bind 引入方法

本文介绍在 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 的 <exclude*> 配置仅用于编译器参数控制，无法影响依赖解析阶段——这也是你尝试失败的根本原因。

✅ 正确方案：全局排除 + 条件化声明

采用“先彻底排除，再按需恢复”的策略，通过 Maven Profile 实现 JDK 版本感知：

1. 全局排除所有来源的 jakarta.xml.bind-api

在 <dependencyManagement> 或直接在 <dependencies> 中使用 <exclusions>，确保无论来自 CXF、JAXB Runtime 或其他库，该依赖均不进入 classpath：

<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 的功能完整性。