如何正确使用 WildFly BOM 管理 CDI API 依赖版本

本文详解在 maven 中通过 wildfly bom（bill of materials）统一管理 java ee 8 相关依赖（如 `cdi-api`）的正确配置方式，重点解决因缺失 `import` 作用域和错误 bom 选型导致的“missing version”构建失败问题。

在基于 WildFly 14.0.1.Final 构建企业级 Java 应用时，合理利用 Maven 的 BOM 机制可显著简化依赖版本管理。但许多开发者在初次尝试时会遇到类似如下错误：

[ERROR] 'dependencies.dependency.version' for javax.enterprise:cdi-api:jar is missing.

该错误的根本原因在于：仅声明 BOM 依赖而不指定 import，Maven 不会将其内容导入到当前项目的 dependencyManagement 中——BOM 本身只是“版本清单”，必须通过 import scope 显式引入，才能为子模块提供版本约束。

✅ 正确配置 WildFly BOM（以 Java EE 8 为例）

WildFly 14 对应的是 Java EE 8 规范，因此应使用 wildfly-javaee8 BOM（而非通用 wildfly BOM），并在 中严格设置 scope=import 和 type=pom：

  
    
      org.wildfly.bom
      wildfly-javaee8
      14.0.1.Final
      pom
      import 
    
  

? 补充说明：wildfly-javaee8 BOM 已明确包含 javax.enterprise:cdi-api:2.0 的版本定义（符合 Jakarta EE 8 前的命名规范），而通用 wildfly BOM 主要用于服务器运行时依赖，不保证导出所有 API 接口的版本声明。

✅ 正确声明 CDI API 依赖（子模块 POM）

在具体模块中引用 cdi-api 时，只需声明 groupId 和 artifactId，Maven 将自动从 BOM 中继承版本号；同时，由于 CDI API 由 WildFly 容器原生提供，应用中应使用 provided scope，避免重复打包引发类冲突或部署失败：

  
    javax.enterprise
    cdi-api
    provided 
  

⚠️ 常见误区与注意事项

• ❌ 错误：在 dependencyManagement 中遗漏 import → BOM 不生效，Maven 无法解析 cdi-api 版本；
• ❌ 错误：使用 wildfly BOM 替代 wildfly-javaee8 → 后者才完整覆盖 Java EE 8 API（包括 CDI、JAX-RS、Bean Validation 等）；
• ❌ 错误：将 cdi-api 设为 compile 或默认 scope → 可能导致 cdi-api.jar 被打包进 WAR/EAR，与 WildFly 内置版本冲突，引发 ClassCastException 或 WeldException；
• ✅ 最佳实践：BOM 应置于多模块项目的 父 POM 的 中；各子模块按需声明无版本依赖，并显式指定 provided（对容器 API）或 runtime（如 JDBC 驱动）等合适 scope。

✅ 验证是否生效

执行以下命令检查 cdi-api 是否已正确解析版本：

mvn dependency:tree -Dincludes=javax.enterprise:cdi-api

预期输出应包含类似：

[INFO] \- javax.enterprise:cdi-api:jar:2.0:provided

这表明 BOM 已成功注入版本 2.0，且 scope 正确。

通过以上配置，你不仅能彻底规避 “Missing version” 错误，还能确保项目与 WildFly 14 的 Java EE 8 运行时契约保持一致，提升可维护性与部署稳定性。