JBOSS EAP7.4部署EAR后抛出NoSuchMethodError问题求助

出现java.lang.NoSuchMethodError: org.apache.commons.collections.CollectionUtils.isEmpty(Ljava/util/Collection;)Z异常的核心原因是类加载冲突或模块可见性限制：

• JBOSS EAP 7.4自带Redhat定制版的commons-collections（commons-collections-3.2.2.redhat-2.jar），且该模块被标记为private，默认应用无法直接访问其完整API；
• 你的应用依赖标准版3.2.2，但JBOSS的模块类加载器优先加载自带的私有模块，导致运行时调用的类与编译时依赖的类不一致，或自带版本缺失目标方法。

解决步骤 #

1. 验证JBOSS自带jar的方法完整性

解压C:\jboss-eap-7.4\modules\system\layers\base\org\apache\commons\collections\main\commons-collections-3.2.2.redhat-2.jar，查看org.apache.commons.collections.CollectionUtils类，确认是否存在isEmpty(Collection)方法：

• 若方法不存在，说明Redhat定制版移除了该方法，需采用步骤2的方案；
• 若方法存在，说明是模块可见性问题，可选择步骤2或3。

2. 让应用使用自身打包的commons-collections（推荐）

这种方式无需修改JBOSS全局配置，隔离性更好：

• 在EAR的META-INF目录下创建jboss-deployment-structure.xml，添加配置排除JBOSS自带模块：

  <jboss-deployment-structure>
      <deployment>
          <exclusions>
              <module name="org.apache.commons.collections" />
          </exclusions>
      </deployment>
  </jboss-deployment-structure>
  

• 确保Gradle配置中commons-collections依赖被正确打包：保持implementation ('commons-collections:commons-collections:3.2.2')配置，同时检查EAR打包逻辑，确保该jar被放入EAR的lib目录或WAR模块的WEB-INF/lib目录。

3. 修改JBOSS模块的可见性（不推荐）

若必须使用JBOSS自带模块，可调整其可见性：

• 编辑C:\jboss-eap-7.4\modules\system\layers\base\org\apache\commons\collections\main\module.xml，将jboss.api属性值从private改为public：

  <property name="jboss.api" value="public"/>
  

• 重启JBOSS后重新部署应用。

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