WildFly 10向远程ActiveMQ Artemis发消息时出现NoSuchMethodError

核心问题分析 #

NoSuchMethodError 本质是类路径中存在多个版本的Netty类，或使用的Netty版本与WildFly 10、JBPM 6.5、ActiveMQ Artemis的依赖版本不兼容。WildFly 10自带特定版本的Netty（通常为4.0.x系列），独立ActiveMQ Artemis可能依赖更高版本（如4.1.x+），JBPM 6.5也有自身Netty依赖，三者冲突导致方法找不到。直接替换WildFly内置Netty会破坏服务器自身依赖链（如Undertow、Remoting组件依赖内置Netty），这就是替换后服务器无法启动的原因。

具体解决步骤 #

1. 明确各组件的Netty依赖版本 #

• 查看WildFly 10内置Netty版本：在WildFly安装目录的 modules/system/layers/base/io/netty 下查看模块定义（比如WildFly 10.1.0.Final用的是Netty 4.0.33.Final）。
• 确认JBPM 6.5的Netty依赖：查看JBPM部署包的lib目录或其pom.xml，明确它兼容的Netty版本。
• 核对独立ActiveMQ Artemis的Netty依赖：查看Artemis官方文档或其lib目录下的netty jar包版本，优先选择与WildFly 10兼容的Artemis版本（比如Artemis 1.5.x系列兼容性较好）。

2. 通过类加载隔离解决版本冲突 #

不要替换WildFly内置Netty，而是为冲突的部署添加类加载隔离配置：

• 在JMS应用或JBPM部署的 jboss-deployment-structure.xml 中，排除WildFly内置的Netty模块，同时引入兼容的Netty版本作为部署私有依赖。示例配置：

  <jboss-deployment-structure>
      <deployment>
          <exclusions>
              <module name="io.netty" />
          </exclusions>
          <dependencies>
              <!-- 需先在WildFly中添加对应兼容模块 -->
              <module name="io.netty.compat" slot="4.1" export="true" />
          </dependencies>
      </deployment>
  </jboss-deployment-structure>
  

• 手动在WildFly中添加兼容Netty模块：在 modules/system/layers/base/io/netty/compat/main 目录下创建模块，放入对应版本的netty jar包，编写 module.xml 定义依赖关系。

3. 对齐ActiveMQ Artemis客户端与服务器版本 #

确保JMS应用使用的Artemis客户端版本与独立服务器版本一致，若客户端依赖高版本Netty，将这些jar包打包到应用的 WEB-INF/lib（或 META-INF/lib）中，同时通过 jboss-deployment-structure.xml 排除WildFly内置Netty，让应用优先使用自身携带的版本。

4. 单独配置JBPM的类加载规则 #

若隔离后JBPM出现问题，检查JBPM部署的 jboss-deployment-structure.xml，确保它依赖的Netty版本与WildFly内置版本一致，或单独为JBPM隔离出兼容的Netty模块。

5. 清理重复依赖 #

检查所有部署应用（JMS、JBPM）的lib目录，移除重复的Netty jar包，避免类路径冲突。

关键注意事项 #

• 优先通过类加载隔离解决版本冲突，不要轻易修改WildFly核心模块。
• 确保所有组件依赖版本匹配：Artemis服务器 ↔ Artemis客户端 ↔ Netty版本 ↔ WildFly/JBPM兼容版本。
• 分步测试：先单独验证JMS应用与独立Artemis的连接，再加入JBPM实例测试，精准定位冲突点。

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