本地编译通过,打包后启动,或者第一次走到某个接口时,Java 却报了 NoSuchMethodError。这时先从完整报错里找到调用的方法,再确认 JVM 实际从哪个 JAR 加载了提供这个方法的类。两处对上,才知道该查构建还是部署。

下面用 JDK 17 和模拟的功能开关库举例。排查命令按 Linux Bash 写,Spring Boot 3.x 部分针对用 java -jar 启动的可执行 JAR。

先抄下完整的方法签名

例如,调用方编译时用了 flags-2.0.jar,运行目录里却只有 flags-1.0.jar。JVM 解析调用时,旧版 FlagClient 找不到这一签名,就会出现下面的错误。JDK 对 NoSuchMethodError 的说明

java.lang.NoSuchMethodError: 'boolean demo.lib.FlagClient.enabled(java.lang.String)'

这条信息给出了类名、参数和返回类型。再翻一下下面的调用栈,找到实际调用这段代码的位置。只搜索 enabled 容易看漏,比如旧版也有这个名字,但它不接收参数。

从类加载日志里找到那个 JAR

用相同的启动包和 JDK,在可复现的环境里开启类加载日志。下面从应用目录运行,假设当前目录可写,把 app.jar 和类名换成现场的值。若异常只有调用接口时才出现,先触发一次对应请求,然后在另一个终端查日志。JDK 17 java 命令的日志选项

java -Xlog:class+load=info:file=class-load.log -jar app.jar
# 触发故障路径后,在同一目录的另一个终端查询
grep -F 'demo.lib.FlagClient source:' class-load.log

看对应行的 source:。例如它指向 flags-1.0.jar,就优先检查那一份实际被加载的文件。如果程序在容器里运行,后续也拿容器使用的产物来查。本地 target 目录里的同名文件可能来自另一次构建。

拿实际加载的包看方法

Spring Boot 可执行 JAR 的依赖通常在 BOOT-INF/lib/。假设类加载日志指向包内的 flags-1.0.jar,可以在一个空目录中提取这一个条目,再直接检查它。把 /path/to/app.jar 换成实际的绝对路径。如果依赖本来就是磁盘上的独立 JAR,可以拿日志中的路径直接运行 javap。Spring Boot 可执行 JAR 的结构 · JDK 17 javap 的签名选项

jar --list --file /path/to/app.jar | grep -F 'BOOT-INF/lib/flags-'
jar --extract --file /path/to/app.jar BOOT-INF/lib/flags-1.0.jar
javap -s -classpath BOOT-INF/lib/flags-1.0.jar demo.lib.FlagClient

在本机 Windows 上用 JDK 17.0.15 做了一个小实验。调用类按 2.0 版编译,运行时只给它 1.0 版,复现了上面的错误,类加载日志指向 flags-1.0.jar。用 javap -s 看两个包,旧版的 enabled() 是 ()Z,新版的 enabled(String) 是 (Ljava/lang/String;)Z。只把运行时的依赖换回 2.0 后,程序输出了预期的 true。

如果现场的方法来自父类或接口,也要核对那些类的实际来源,尤其是不同框架或插件各有类加载器时。

构建产物和部署路径分别对一次

如果应用包里带的就是旧版,回到产出它的 Maven 模块,用与发布构建一致的 profile 看依赖树。示例坐标 demo.lib:flags 需要换成实际的 groupId:artifactId。Maven dependency:tree 参数说明

mvn dependency:tree -Dincludes=demo.lib:flags

顺着输出看版本是由直接依赖、传递依赖还是父 POM 或 BOM 里的管理规则选出来的。找出来源后,再决定统一版本还是排除一条重复路径。构建包里已经是预期版本时,则检查部署用的镜像、挂载路径和启动命令,确认运行进程指向本次交付的产物。Maven 依赖冲突排查

改完用准备发布的包重走当初报错的入口和调用参数,确认类加载日志指向预期 JAR,再核对这次请求的返回结果。