Java EE项目ASM版本冲突致WS客户端报错（WildFly 9环境）

你碰到了典型的ASM版本兼容坑——wsimport生成的Web服务客户端绑定了ASM 3.3，而另一个组件又必须依赖ASM 4.1，WildFly自带的ASM 3.3没法同时满足两者。排除服务器内置ASM后WS客户端直接炸锅，核心原因是ASM 3和4之间存在API不兼容：MethodWriter.visitLabel的方法签名在两个版本里有变化，导致依赖ASM 3.3的WS客户端找不到它需要的方法。

下面给你几个可行的解决方案，按推荐程度排序：

方案1：用WildFly模块隔离实现双ASM版本共存 #

这是最稳妥的方式，通过配置让WS客户端和其他组件分别加载各自需要的ASM版本：

1. 创建ASM 3.3自定义模块
   在WildFly的modules目录下新建org/objectweb/asm/3.3文件夹，把asm-3.3.jar放进去，然后创建module.xml：

   <?xml version="1.0" encoding="UTF-8"?>
   <module xmlns="urn:jboss:module:1.3" name="org.objectweb.asm.3">
       <resources>
           <resource-root path="asm-3.3.jar"/>
       </resources>
   </module>
   

   如果你没把ASM 4.1打包进WAR，也可以用同样的方式为它创建org.objectweb.asm.4模块。

2. 配置部署结构文件
   在你的WAR包的WEB-INF目录下创建jboss-deployment-structure.xml，用来排除服务器内置ASM，并指定不同包加载不同版本的ASM：

   <?xml version="1.0" encoding="UTF-8"?>
   <jboss-deployment-structure>
       <deployment>
           <!-- 排除WildFly自带的ASM模块 -->
           <exclusions>
               <module name="org.objectweb.asm"/>
           </exclusions>
           <!-- 为WS客户端和其他组件分别指定ASM依赖 -->
           <dependencies>
               <!-- WS客户端用ASM3.3，export=false避免污染其他类加载器 -->
               <module name="org.objectweb.asm.3" export="false"/>
               <!-- 其他组件用ASM4.1 -->
               <module name="org.objectweb.asm.4" export="false"/>
           </dependencies>
           <!-- 配置类过滤，让不同包加载对应版本的ASM -->
           <class-filter>
               <!-- 替换成你的WS客户端实际包路径 -->
               <filter-regex>com/yourcompany/wsclient/.*</filter-regex>
               <module name="org.objectweb.asm.3"/>
           </class-filter>
           <class-filter>
               <!-- 替换成你的其他组件实际包路径 -->
               <filter-regex>com/yourcompany/othercomponent/.*</filter-regex>
               <module name="org.objectweb.asm.4"/>
           </class-filter>
       </deployment>
   </jboss-deployment-structure>
   

   配置完成后，WS客户端的类会优先加载ASM 3.3，其他组件则使用ASM 4.1，完美隔离版本冲突。

方案2：重新生成WS客户端，兼容ASM 4.1 #

如果不想折腾服务器模块，你可以尝试用更现代的工具重新生成WS客户端，让它适配ASM 4.1：

• 放弃旧版JDK的wsimport，改用Apache CXF的wsdl2java工具生成客户端。CXF的新版本对ASM的兼容性更好，生成的代码不会绑定到ASM 3.3。
  示例命令：

  wsdl2java -d src/main/java -p com.yourcompany.wsclient http://your-ws-endpoint?wsdl
  

• 或者用JDK 8及以上版本的wsimport，新版工具生成的客户端可能已经兼容更高版本的ASM。

重新生成后，检查客户端的依赖，确保它不再强制要求ASM 3.3，这样就能和你的其他组件共用ASM 4.1了。

方案3：打包ASM 3.3到WAR并调整类加载顺序 #

如果不想碰服务器配置，也可以把asm-3.3.jar打包到WAR的WEB-INF/lib，然后通过jboss-deployment-structure.xml配置让WS客户端的类优先加载这个本地JAR：

<?xml version="1.0" encoding="UTF-8"?>
<jboss-deployment-structure>
    <deployment>
        <exclusions>
            <module name="org.objectweb.asm"/>
        </exclusions>
        <!-- 让本地JAR优先加载 -->
        <module-order>before</module-order>
        <local-last value="false"/>
        <!-- 只为WS客户端包指定本地ASM3.3的加载优先级 -->
        <class-filter>
            <filter-regex>com/yourcompany/wsclient/.*</filter-regex>
            <resource-root path="WEB-INF/lib/asm-3.3.jar"/>
        </class-filter>
    </deployment>
</jboss-deployment-structure>

这种方式适合快速测试，但要注意如果WAR里同时有ASM 3.3和4.1，其他组件可能会误加载到ASM 3.3，所以最好配合类过滤来精准控制。

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