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

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

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

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

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

  
  
    org.apache.cxf
    cxf-core
    3.5.3
    
      
        jakarta.xml.bind
        jakarta.xml.bind-api
      
      
        org.glassfish.jaxb
        jaxb-runtime
      
    
  

⚠️ 注意：若依赖链较深（如 cxf-core → jaxb-runtime → jakarta.xml.bind-api），建议对最上游依赖（如 cxf-core）做 exclusion，而非逐层排除，更简洁可靠。

2. 仅在 JDK 11+ 环境中激活 Profile 声明依赖

利用 Maven 的 JDK 激活机制，定义一个仅在 JDK ≥ 11 时生效的 Profile：

  
    jdk11-plus
    
      [11,) 
    
    
      
      
        jakarta.xml.bind
        jakarta.xml.bind-api
        4.0.0
      
      
        org.glassfish.jaxb
        jaxb-runtime
        4.0.3 
      
    
  

✅ 效果验证：

• 使用 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 构建中出现：

  
    org.apache.maven.plugins
    maven-enforcer-plugin
    
      
        ban-jakarta-bind-on-jdk8
        validate
        
          
            
              
                jakarta.xml.bind:jakarta.xml.bind-api
              
              Jakarta XML Bind is forbidden on JDK 8 (already provided by JVM).
            
          
        
        enforce
      
    
  

• CI/CD 建议：在流水线中分别用 openjdk:8-jdk 和 openjdk:17-jdk 执行构建，双重验证 Profile 行为正确性。

通过此方案，你实现了真正语义清晰、可维护性强的 JDK 版本条件依赖管理——既规避了 JDK 8 的类冲突风险，又保障了高版本 JDK 的功能完整性。