Maven升级mule-core传递依赖后仍报NoSuchMethodError如何解决？

问题现状 #

当前项目依赖链路：

• MyProject 依赖企业库A，企业库A 依赖 mule-core v3.4

已通过Maven排除企业库A中所有mule相关传递依赖，显式引入mule-core v3.9，校验fat jar包内容仅包含v3.9版本的mule-core，但运行时仍抛出方法不存在错误。
两个版本的方法签名差异如下：
mule-core v3.4中对应方法：

public void initialize(final ExpressionManager expressionManager)

mule-core v3.9中同方法修改了返回值：

public AttributeEvaluator initialize(final ExpressionManager expressionManager)

JVM进行方法匹配时会将返回值纳入签名校验，因此编译时绑定了void返回值方法的企业库A，在v3.9版本中找不到对应签名的方法，抛出错误：

Caused by: java.lang.NoSuchMethodError: org.mule.util.AttributeEvaluator.initialize(
   Lorg/mule/api/expression/ExpressionManager;)V

优先排查项 #

先确认类加载路径污染问题：fat jar包内容正确但运行加载旧类，基本都是类加载优先级导致的。检查以下位置是否存在旧版mule-core包：

• 应用启动脚本中-cp参数指定的额外类路径
• 部署容器（如Tomcat、Weblogic）的公共lib目录
• JDK扩展类加载路径下的第三方包

排除以上问题后，不需要引入企业库A源码重编译，可选择以下更轻量的解决方案：

可选解决方案 #

• 最小改动兼容补丁
  配合Maven Shade插件的类重定位能力，将mule-core v3.9中原生的org.mule.util.AttributeEvaluator类重定位到自定义包路径（比如org.mule.compat.v39.util.AttributeEvaluator），再在当前项目源码中创建全限定名org.mule.util.AttributeEvaluator的兼容类，继承重定位后的v3.9原生类，补充旧签名的兼容方法：

  package org.mule.util;
  import org.mule.api.expression.ExpressionManager;
  
  public class AttributeEvaluator extends org.mule.compat.v39.util.AttributeEvaluator {
      // 兼容v3.4版本的void返回值initialize方法
      public void initialize(final ExpressionManager expressionManager) {
          // 直接调用v3.9的新方法，丢弃返回值即可
          super.initialize(expressionManager);
      }
  }
  

  该方案不会出现类循环加载问题，运行时企业库A调用旧签名方法时会直接命中补丁类的兼容逻辑，改动量极小，不需要修改任何第三方依赖的源码。
• 第三方Jar字节码重打包
  不需要将企业库A的源码合入当前项目，使用Javassist、Byte-Buddy等字节码工具，离线对企业库A的发布包做修改，将所有调用旧initialize方法签名的字节码引用，替换为匹配v3.9版本的新签名，将修改后的jar包上传到私服或本地Maven仓库作为私有依赖引用即可。
• Maven Shade插件构建期字节码改写
  打fat jar时配置Shade插件的自定义类转换器，在打包阶段自动扫描企业库A中的方法调用指令，将旧签名的方法引用改写为适配v3.9版本的逻辑，不需要提前修改第三方jar，所有适配逻辑在构建阶段自动完成。

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