如何根据 JDK 版本条件化排除或引入 Maven 依赖

本文介绍在多 jdk 版本兼容构建场景下，如何通过 maven profile 实现对 `jakarta.xml.bind-api` 等模块化 api 依赖的精准控制：jdk 8 构建时完全排除，jdk 11+ 构建时按需显式引入。

在 Java 9 引入模块系统后，javax.xml.bind（及其后续 Jakarta 命名空间迁移版本）等 API 被从 JDK 中移除。因此，JDK 11+ 项目需显式声明 jakarta.xml.bind-api 和运行时实现（如 jaxb-runtime），而 JDK 8 项目则不应包含该依赖——否则可能引发类冲突、重复包加载或 JEE 容器部署失败（如 WebLogic/Tomcat 在 JDK 8 下因 jakarta.* 类与内置 javax.* 绑定机制不兼容而报错）。

Maven 本身不支持“按当前编译 JDK 版本动态排除传递依赖”，maven-compiler-plugin 的 配置项并非用于依赖过滤，而是针对编译器插件自身的资源处理逻辑，无法影响依赖解析阶段（Dependency Resolution）。正确解法是采用 “全局排除 + 条件化重引入” 策略：

✅ 步骤一：全局排除 jakarta.xml.bind-api

在 或直接在 中，使用 显式切断所有来源的该依赖（包括 cxf-core 等传递路径）：

  org.apache.cxf
  cxf-core
  3.5.3
  
    
      jakarta.xml.bind
      jakarta.xml.bind-api
    
  

⚠️ 注意：若多个依赖引入该 API，需对每个源头逐一排除；也可在 中统一声明 provided 或 true，但最稳妥方式仍是显式 exclusion。

✅ 步骤二：通过 JDK 激活 Profile 有条件引入

在 pom.xml 根节点下定义 Profile，仅当检测到 JDK ≥ 11 时激活，并声明所需依赖：

琅琅配音

全能AI配音神器

下载

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

Maven 会自动根据当前 JAVA_HOME 所指向的 JDK 主版本号匹配 [11,) 范围。JDK 8 构建时该 Profile 不激活，依赖不会加入 classpath；JDK 11/17/21 构建时自动启用，确保 API 可用。

✅ 验证与最佳实践

• 使用 mvn help:active-profiles 确认 Profile 是否按预期激活；
• 执行 mvn dependency:tree -Dverbose 检查 jakarta.xml.bind-api 是否彻底消失（JDK 8）或仅出现在 jdk11-plus 分支中（JDK 11+）；
• 若项目还需支持 JDK 17+ 的强封装（如 --add-opens），建议配合 maven-surefire-plugin 配置 JVM 参数；
• 避免使用 jdk8 等非标准字段——Maven 无此语义，属常见误解。

该方案简洁、可移植、符合 Maven 生命周期设计原则，是跨 JDK 版本构建企业级 Java 项目的推荐实践。