Java问题解决录: 运行时抛出NoSuchMethodError / NoSuchFieldError异常

首发地址: https://mp.weixin.qq.com/s?__biz=Mzg4MzcwMTk0Mw==&mid=2247484220&idx=1&sn=06ce29ba0eae325ad6fc1d9953571bb8&chksm=cf4222e4f835abf2a5927e09369142ae72444fc9b50e8ae09ca89242ea1e14b976da7800585f&token=216307076&lang=zh_CN#rd

https://mmbiz.qpic.cn/mmbiz_jpg/K5AWcTRtu4U8ewGsxibfLGVZmo2cwUKyra16g3zJrAJjH62vEJb2KicMP6ydGTSnoCpM3R7GQKFk9hM4pRUNxy7g/640?wx_fmt=jpeg&wxfrom=5&wx_lazy=1&wx_co=1Java问题解决录: 运行时抛出NoSuchMethodError / NoSuchFieldError异常

现象

IDE中编译运行没问题,但是打包成可运行jar(spring boot jar包运行)抛出异常:NoSuchMethodError 或 NoSuchFieldError异常。

如何定位问题

根据类加载机制判断,此类肯定被加载了,加载的到底是哪个类呢,因为本地IDE中可能没问题。

理性判断:根据类加载机制

为了查看类的加载情况,我们可以应用启动时,增加JVM参数:
-verbose:class、
或-XX:+TraceClassLoading (旧版本jdk)、
或-Xlog:class+load=debug(新版本jdk,目前jdk17用的此配置);
https://docs.oracle.com/en/java/javase/17/docs/specs/man/java.html#convert-runtime-logging-flags-to-xlog

本地模拟IDE启动添加参数:

https://mmbiz.qpic.cn/mmbiz_png/K5AWcTRtu4X9uHgicxvghzXwBkVTFxicGvArIuNMyp1iaKklwMH3WFsMCYfzdLLEHsIS1epxcBibabRQ3n0pm3zdCg/640?wx_fmt=png&wxfrom=5&wx_lazy=1&wx_co=1Java问题解决录: 运行时抛出NoSuchMethodError / NoSuchFieldError异常

https://mmbiz.qpic.cn/mmbiz_png/K5AWcTRtu4X9uHgicxvghzXwBkVTFxicGvFW14baTjBUdZiaV9ibL1FaNSrCjHV7FbsxMOtWJQAoedVAxqRiaemAkpQ/640?wx_fmt=png&wxfrom=5&wx_lazy=1&wx_co=1Java问题解决录: 运行时抛出NoSuchMethodError / NoSuchFieldError异常

当然,如果我们服务器使用了阿里开源的Arthas,可以使用jad命令来查看反编译指定已加载类的源码:

https://arthas.aliyun.com/doc/jad.html#反编译时指定-classloader

以上工具可以查看类的加载路径及jar包版本号,而且还能看到使用的类加载器。

人肉判断

1、IDE搜此类,如果定义出现在两个jar包,基本就是重复类定义导致的;

2、IDE搜此类,如果出现在一个jar包,看maven依赖树,是否存在多个版本,定义是否相同,版本是否被覆盖(高版本覆盖低版本、低版本覆盖高版本);

根据maven的传递依赖规则,或者直接解压打包的应用,看最终打进去的jar包版本,或登录服务器查看;

3、看代码,是否反射,定义写错导致的;

运行时抛出NoSuchMethodError / NoSuchFieldError异常问题原因分类

1、重复类导致的;

同包同名类,实现不一样,类加载器只加载第一个找到的,而使用的类恰恰是有问题的。同名同包类可能在一个第三方jar包中,但大多数位于两个jar包中。

2、传递依赖多个版本冲突-最终生效的只有一个版本;

根据maven的传递依赖特性,maven根据广度优先遍历算法来决定使用哪个冲突的版本号。有可能是高版本覆盖了低版本,也有可能是低版本覆盖了高版本。

3、反射机制,定义传递错误;

如何编译期发现

如果项目使用的是maven工具,我们可以使用extra-enforcer-rules中的
Ban Duplicate Classes规则来强制编译报错。
https://www.mojohaus.org/extra-enforcer-rules/banDuplicateClasses.html


<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-enforcer-plugin</artifactId>
  <version>1.4.1</version>
  <executions>
    <execution>
      <id>enforce</id>
      <configuration>
        <rules>
          <dependencyConvergence/>
        </rules>
      </configuration>
      <goals>
        <goal>enforce</goal>
      </goals>
    </execution>
    <execution>
      <id>enforce-ban-duplicate-classes</id>
      <goals>
        <goal>enforce</goal>
      </goals>
      <configuration>
        <rules>
          <banDuplicateClasses>
            <ignoreClasses>
              <ignoreClass>javax.*</ignoreClass>
              <ignoreClass>org.junit.*</ignoreClass>
              <ignoreClass>net.sf.cglib.*</ignoreClass>
              <ignoreClass>org.apache.commons.logging.*</ignoreClass>
              <ignoreClass>org.springframework.remoting.rmi.RmiInvocationHandler</ignoreClass>
            </ignoreClasses>
            <findAllDuplicates>true</findAllDuplicates>
          </banDuplicateClasses>
        </rules>
        <fail>true</fail>
      </configuration>
    </execution>
  </executions>
  <dependencies>
    <dependency>
      <groupId>org.codehaus.mojo</groupId>
      <artifactId>extra-enforcer-rules</artifactId>
      <version>1.0-beta-6</version>
    </dependency>
  </dependencies>
</plugin>

如果你使用的是Android Studio(Gradle工具),很可能经常会碰到这类编译错误提示。

反射这种方式导致的,目前还没能自动检测工具。

小结

https://mmbiz.qpic.cn/mmbiz_png/K5AWcTRtu4X9uHgicxvghzXwBkVTFxicGvKhKXbDJvZal7PDBem4RrwK0QcppBML3r8NJUSicEzrUOTLH4JNibDTDw/640?wx_fmt=png&wxfrom=5&wx_lazy=1&wx_co=1Java问题解决录: 运行时抛出NoSuchMethodError / NoSuchFieldError异常