如何根据 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