NoSuchMethodError 根本原因是运行时加载的类版本过旧，如 httpclient 4.2.x 缺少 4.5+ 的 setEntity(HttpEntity) 方法；需用 mvn dependency:tree 定位多版本冲突，-verbose:class 确认实际加载 JAR，优先用 切断污染依赖并显式声明正确版本。
直接看报错栈里调用链最深的类和方法
出现 NoSuchMethodError 时，JVM 已经在运行时发现某个类里找不到期望的方法签名。关键不是“类没加载”，而是“加载的类版本不对”——它可能来自旧版 JAR、被 Maven 传递依赖覆盖的间接依赖，或 IDE 缓存了过期字节码。
先别急着升级/降级，打开异常堆栈，定位最后一行形如 at com.example.service.UserService.save(UserService.java:42) 的调用点，再往上翻到最靠近 Caused by: 的那一行，例如：java.lang.NoSuchMethodError: org.apache.http.client.methods.HttpPost.setEntity(Lorg/apache/http/HttpEntity;)V
这说明：当前运行时加载的 org.apache.http.client.methods.HttpPost 类，不包含接受 HttpEntity 参数的 setEntity 方法——大概率是加载了老版本（比如 4.2.x）的 httpclient，而代码编译时链接的是 4.5+ 的 API。
用 mvn dependency:tree 查真实加载路径
在项目根目录执行：mvn dependency:tree -Dincludes=org.apache.httpcomponents:httpclient
如果输出里出现多个版本（比如同时有 4.2.6 和 4.5.14），就坐实了冲突。注意看每条路径末尾的 (omitted for duplicate) 或 (omitted for conflict) 标记——Maven 默认只保留第一个声明的版本，但实际生效的未必是你想用的那个。
常见诱因包括：
- 某个老 SDK（如某银行支付 SDK）强制引入低版本
httpclient，且没做<exclusion></exclusion> -
spring-boot-starter-web依赖的spring-boot-starter-reactor-netty拉入了新版本，但你手动<scope>provided</scope>了旧版，导致运行时 fallback 到容器提供的版本 - IDE 没刷新 Maven 依赖，或本地
.m2/repository里存在损坏的 JAR（校验和不匹配）
运行时确认到底加载了哪个 JAR 文件
启动应用时加 JVM 参数：-verbose:class -XX:+TraceClassLoadingPreorder
或更轻量的：-Dsun.misc.URLClassPath.debug=true
然后 grep 日志里对应类名，例如：grep "HttpPost" application.log
你会看到类似：[Loaded org.apache.http.client.methods.HttpPost from file:/home/user/.m2/repository/org/apache/httpcomponents/httpclient/4.2.6/httpclient-4.2.6.jar]
这就锁定了罪魁祸首。不要只信 pom.xml 里写的版本，运行时 classpath 才是真相。
补充技巧：
- 在 IDEA 中按
Ctrl+Click跳转到HttpPost，看右下角显示的 JAR 路径是否和日志一致 - 用
jcmd <pid> VM.native_memory summary</pid>配合jstack可辅助判断是否多个 ClassLoader 加载了同名类 - Spring Boot 项目可访问
/actuator/env看systemProperties里有没有意外覆盖的java.class.path
排除依赖时优先用 <exclusion></exclusion> 而非 <scope>runtime</scope>
<scope>runtime</scope> 不会阻止编译期传递依赖解析，只影响打包；而 <exclusion></exclusion> 是从源头切断污染路径。
例如修复上面的 httpclient 冲突：
<dependency><br> <groupId>com.somebank.sdk</groupId><br> <artifactId>payment-sdk</artifactId><br> <version>2.1.0</version><br> <exclusions><br> <exclusion><br> <groupId>org.apache.httpcomponents</groupId><br> <artifactId>httpclient</artifactId><br> </exclusion><br> </exclusions><br></dependency>
之后显式声明你信任的版本：
<dependency><br> <groupId>org.apache.httpcomponents</groupId><br> <artifactId>httpclient</artifactId><br> <version>4.5.14</version><br></dependency>
注意：
- 别用
<scope>provided</scope>去“绕过”冲突——它只是把问题推迟到运行时，且容易被容器忽略 - Spring Boot 2.7+ 用户要小心
spring-boot-dependenciesbom 里对httpclient的管理版本，<exclusion></exclusion>后建议配合<properties><httpclient.version>4.5.14</httpclient.version></properties> - Gradle 用户等效写法是
configurations.all { resolutionStrategy { force 'org.apache.httpcomponents:httpclient:4.5.14' } }
