Wildfly-BOM默认未加载依赖的手动配置及相关技术咨询

我们将多数Maven依赖设置为<scope>provided</scope>，因为这些依赖由WildFly服务器提供。通过导入WildFly-BOM来确认服务器提供的依赖，配置如下：

<!-- WildFly EE BOM -->
<dependency>
   <groupId>org.wildfly.bom</groupId>
   <artifactId>wildfly-ee</artifactId>
   <version>31.0.0.Final</version>
   <scope>import</scope>
   <type>pom</type>
</dependency>

但部署应用时出现org/apache/http类找不到的问题，排查后发现org.apache.httpcomponents未被WildFly默认加载，需在standalone.xml中手动添加以下配置：

<subsystem xmlns="urn:jboss:domain:ee:6.0">
   <global-modules>
      <module name="org.apache.httpcomponents"/>
   </global-modules>
   ...
</subsystem>

针对以下问题解答如下：

1. 为何org.apache.httpcomponents在Wildfly-BOM中列出，却未被默认加载？ #

WildFly的BOM主要作用是统一依赖版本，同时声明服务器支持的所有可选与核心依赖范围，但并非BOM里的所有模块都会被服务器自动加载。WildFly默认仅加载运行Jakarta EE核心规范必需的模块，org.apache.httpcomponents属于第三方扩展模块，不属于核心运行时的默认加载集合，因此需要手动配置全局模块让服务器加载。

2. Wildfly-BOM中还有哪些依赖需要手动添加到standalone.xml？ #

没有固定的清单，完全取决于你的应用实际使用的非核心模块。通常需要手动配置的模块类型包括：

• 第三方扩展库（如Apache Commons系列、Jackson特定扩展包、非默认内置的JDBC驱动等）
• 不属于Jakarta EE标准的WildFly附加模块

判断方法：当应用部署时抛出ClassNotFoundException或NoClassDefFoundError，且对应的类存在于WildFly安装目录的modules/system/layers/base/下的模块中，就需要将该模块添加到<global-modules>里。

3. 该类问题的相关说明文档可在何处查阅？ #

可直接查阅WildFly官方文档的对应部分：

• 模块系统文档：讲解WildFly的模块加载机制、全局模块的配置逻辑
• EE子系统配置文档：详细说明<global-modules>节点的配置方式与作用
• 本地模块清单：WildFly安装目录下的modules目录中，每个模块都包含module.xml文件，可查看模块的依赖关系与加载规则

内容的提问来源于stack exchange，提问作者canEE