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=1

现象

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=1

https://mmbiz.qpic.cn/mmbiz_png/K5AWcTRtu4X9uHgicxvghzXwBkVTFxicGvFW14baTjBUdZiaV9ibL1FaNSrCjHV7FbsxMOtWJQAoedVAxqRiaemAkpQ/640?wx_fmt=png&wxfrom=5&wx_lazy=1&wx_co=1

当然，如果我们服务器使用了阿里开源的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=1