IDEA报错：java.lang.NoSuchFieldError 和 NoSuchMethodError

最新推荐文章于 2025-10-30 21:16:32 发布

原创最新推荐文章于 2025-10-30 21:16:32 发布 · 7.4k 阅读

2 ·

CC 4.0 BY-SA版权

文章标签：

#java #intellij-idea #开发语言

文章介绍了在Java开发中遇到NoSuchFieldError和NoSuchMethodError的场景，分析了两种可能的原因：jar包版本冲突和项目中存在同名类。提供了通过Maven的依赖管理工具排查和解决问题的步骤，包括检查依赖冲突、排除不需要的jar包以及检查项目中是否存在相同路径和命名的类。最后提醒，如果排除冲突后问题仍存在，可能是pom.xml重复引入了jar包，需要删除重复项。

1、报错信息
java.lang.NoSuchFieldError 和 NoSuchMethodError
2、场景
通过Maven引入了一个jar包，某一天新增了一个类的属性或者静态属性。然后发现编译完全正确，但是实际运行一直在报NoSuchFieldError。
3、造成原因只有以下两种（不用想其他的，没有其他可能）
1、你项目中有同一个jar包的不同版本，编译和运行时使用了不同的jar包。比如有两个版本1.1.3和1.1.4（有新增属性）。编译的时候使用1.1.4，编译正常通过。但是运行的时候使用的是1.1.3。
2、你的项目中存在和jar包中路径和类名完全相同的类。因为你新增了属性本地类中没有，所以编译的时候会自动使用Jar包中的对象，但是运行的时候则会优先使用本地的对象！！！

4、排查流程
1、第一步：排查存在多个Jar包引用
使用ideal自带到Maven工具（show Dependencies），如果查处两个的话就要注意啦（敲黑板），你可以直接点到不是你需要的那个版本，进入查看下是从哪个地方依赖的。
如果是你项目引入的，直接删掉就解决啦，如果是传递依赖（你引用的jar引用了这个jar包），需要使用标签去排除掉。
<dependency>
<groupId>io.vertx</groupId>
<artifactId>vertx-core</artifactId>
<version>${vertx.version}</version>
<exclusions>
<exclusion>
<artifactId>netty-codec</artifactId>
<groupId>io.netty</groupId>
</exclusion>
</exclusions>
</dependency>
1
2
3
4
5
6
7
8
9
10
11
顺手推荐一个工具：Maven Helper
2、第二步：排查你们项目中有相同路径和命名的类

敲黑板：一定要勾选上include non-project items 才能查询到jar包中的类。如果本地有一样的话，看你的抉择啦，删除哪一个你自己选。

上面两步绝对解决问题，如果你试过还是没找到原因，那你找下你的同事check一下，不会有其他可能。

原文链接：https://blog.youkuaiyun.com/weixin_39452168/article/details/108146847

---------------------------------------------------------------------------------------------------------------------

注：安装上述方法排查问题时，发现确实是两个相同的jar包冲突了，但是通过<exclusions>屏蔽掉其中一个jar包后还是报同样的问题，经过检查后发现是pom.xml文件引入了两次相同jar包，所以在注释掉一个之后还是不行。

解决方式：删除相同的jar包，然后通过<exclusions>屏蔽。