本文详解在 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 依赖而不指定 <scope>import</scope>，Maven 不会将其内容导入到当前项目的 dependencyManagement 中——BOM 本身只是“版本清单”，必须通过 import scope 显式引入，才能为子模块提供版本约束。
✅ 正确配置 WildFly BOM（以 Java EE 8 为例）
WildFly 14 对应的是 Java EE 8 规范，因此应使用 wildfly-javaee8 BOM（而非通用 wildfly BOM），并在 <dependencyManagement> 中严格设置 scope=import 和 type=pom：
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.wildfly.bom</groupId>
<artifactId>wildfly-javaee8</artifactId>
<version>14.0.1.Final</version>
<type>pom</type>
<scope>import</scope> <!-- 关键！不可省略 -->
</dependency>
</dependencies>
</dependencyManagement>? 补充说明：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，避免重复打包引发类冲突或部署失败：
<dependencies>
<dependency>
<groupId>javax.enterprise</groupId>
<artifactId>cdi-api</artifactId>
<scope>provided</scope> <!-- 关键！表明由容器提供 -->
</dependency>
</dependencies>⚠️ 常见误区与注意事项
- ❌ 错误：在 dependencyManagement 中遗漏 <scope>import</scope> → 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 的 <dependencyManagement> 中；各子模块按需声明无版本依赖，并显式指定 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 运行时契约保持一致，提升可维护性与部署稳定性。
