老炮踩坑录 · F12 · 翻车现场系列· 番外篇基于「基础企业档案」真实项目代码复盘一次换 IDEA 版本引发的离奇启动失败关键词NoClassDefFoundError · provided scope · dependencyManagement · effective-pom 欢迎阅读个人主页知守观我的专栏老炮踩坑录当前内容Maven范围依赖文章目录前言一开始判断错了方向本地仓库路径先搞错了dependency:tree 定位到 scope很多人没踩过的点BOM 连 scope 一起管为什么偏偏和 IDEA 版本有关修复第二个报错feign-slf4j为什么容易被误导自查清单老炮点评前言今天这篇是番外篇翻出的是另一个项目——基础企业档案一个Spring Cloud微服务项目。离职后整理旧硬盘翻出以前做的另一个 项目它是一个 Spring Cloud 微服务项目。想跑起来看一眼当年写的代码顺手用机器上装着的两个 IDEA 版本各打开了一次。诡异的事出现了。同一个仓库、同一份代码、同一个 JDK一个版本启动正常另一个版本直接报错java.lang.NoClassDefFoundError: feign/Request$Options at org.springframework.cloud.openfeign.FeignClientFactoryBean.init(FeignClientFactoryBean.java:106) ... Caused by: java.lang.ClassNotFoundException: feign.Request$Options报错出现在 Spring 注册FeignClient的阶段。FeignClientFactoryBean初始化时要 new 一个Request.Options类却没有找到。代码一个字没动换个 IDE 就起不来。排查这种问题没有明确线索一时不知道从哪里下手。一开始判断错了方向看到堆栈里的spring-cloud-openfeign-core-3.1.1我第一反应是版本对不上。项目里手写的 openfeign 版本是2.2.3.RELEASE运行时加载的却是 3.1.1版本显然被上层依赖管理覆盖了。具体是父 POM 里哪一层 BOM 生效当时没往上翻先没有继续追查。缺类就补类。我在子模块的 pom 里直接把 feign-core 加上dependencygroupIdio.github.openfeign/groupIdartifactIdfeign-core/artifactId/dependencyReload重启报错一个字没变。依赖写了运行时却没有生效。到这里我意识到问题不在有没有声明依赖。本地仓库路径先搞错了我习惯性去默认仓库找 openfeign 的目录dir$env:USERPROFILE\.m2\repository\io\github\openfeign整个路径不存在。可堆栈里明明有spring-cloud-openfeign-core-3.1.1.jarJAR 不可能凭空出现。直到我跑了一次 mvn日志里一行信息说明了原因——本地仓库路径早就被 settings.xml 改到了D:\Maven\repertory~/.m2下并没有所需的依赖。我一直在错误的仓库路径里查找。dependency:tree 定位到 scope换到正确的仓库路径feign-core 的 JAR 确实存在。JAR 在、声明在、运行时就是没有剩下的可能性只有 scope。mvn dependency:tree-Dincludesio.github.openfeign:feign-corePowerShell 里这个参数不加引号会被解析坏顺手提一下。输出[INFO] cn.linkkids:base-guidang-web:jar:0.0.1-SNAPSHOT [INFO] \- io.github.openfeign:feign-core:jar:11.8:provided末尾两个字provided。很多人没踩过的点BOM 连 scope 一起管provided 的效果不用多讲编译期在、运行期不在。问题是我从来没写过 provided它从哪来的答案在 dependencyManagement 里。不少人对它的印象停留在统一管版本号实际上 version、scope、exclusions 都能在这里一起指定dependencyManagementdependenciesdependencygroupIdio.github.openfeign/groupIdartifactIdfeign-core/artifactIdversion11.8/versionscopeprovided/scope/dependency/dependencies/dependencyManagement上面是示意父 POM 的原文我离职后已经拉不到了。子模块声明依赖时不写 scope就继承管理条目里的 provided自己显式写 scope才能覆盖继承值。我后来查 effective-pom 验证feign-core 的最终 scope 确实是 provided。为什么这么设计我只能推测公司内部部署体系里feign 相关 JAR 可能由统一的基础环境提供业务包刻意不带。翻提交记录或许有答案旧仓库权限已经没了这部分无法确认。为什么偏偏和 IDEA 版本有关这一步的判断我没有直接证据只能根据 IDEA 的配置项推断。IDEA 的运行配置里有个开关Add dependencies with provided scope to classpath。两个 IDEA 版本下这个开关的默认状态、或者老配置迁移后的状态很可能不一样——一边把 provided 依赖带进了运行时 classpath一边没有。旧环境已经不在我机器上没法回头点开那个配置截图验证所以这段只能给到最可能的解释。能确认的事实只有一条feign-core 被解析成 provided这是 Maven 的解析结果不随 IDE 变。修复在子模块显式声明 compile覆盖继承的 provideddependencygroupIdio.github.openfeign/groupIdartifactIdfeign-core/artifactIdscopecompile/scope/dependency再次执行 dependency:tree确认 scope 已变更修改前: io.github.openfeign:feign-core:jar:11.8:provided 修改后: io.github.openfeign:feign-core:jar:11.8:compileReload Maven这次FeignClientFactoryBean初始化没有再报错。第二个报错feign-slf4j重启后应用继续启动又报java.lang.NoClassDefFoundError: feign/slf4j/Slf4jLoggerfeign-slf4j一模一样的 provided。它和 feign-core 同属一个 dependencyManagement 条目一批依赖都是这个 scope。dependencygroupIdio.github.openfeign/groupIdartifactIdfeign-slf4j/artifactIdscopecompile/scope/dependency修改完 feign-slf4j我全量跑了一次 dependency:tree把所有 provided 依赖过一遍确认没有遗漏再重启。这次起来了。为什么容易被误导编译全程不报错provided 本来就参与编译。IDEA 里跳转、补全、代码检查一切正常只有跑起来的那一刻类没了。更迷惑人的是它和环境绑定本地 IDE 里启动失败生产可能运行正常两边对谁来提供这些 JAR的假设完全不同。反复检查业务代码也查不到原因问题不在业务代码这一层。排查这类问题我现在固定用两个命令mvn dependency:tree看实际解析结果-DincludesgroupId:artifactId过滤多模块工程里很有用mvn help:effective-pom看最终合并生效的 POM父 POM、import 进来的 BOM 叠了多少层一目了然。怀疑配置被继承关系修改时先看它。自查清单检查项怎么查危险信号能编译、运行时 NoClassDefFoundErrordependency:tree 看该 JAR 的 scopeprovided 或 scope 与预期不符怀疑版本/scope 被父 POM 改了help:effective-pom 里搜 artifactId生效值和你手写的不一致本地仓库与预期不一致mvn -v确认 local repoIDEA 和命令行指向不同仓库同一框架多个依赖接连报错全量 dependency:tree 扫 provided同组依赖成批出现修一个不够老炮点评你写的 pom.xml从来不是你一个人的 pom.xml。父 POM 往上还有父 POMBOM 里还能 import BOMMaven 真正执行的是所有层合并后的那一份。你在自己这层看到的配置和 effective-pom 里的实际内容可能完全不同。对隐式继承的配置保持警惕比背熟多少条 scope 规则都管用。下期预告《多模块工程没 install跑起来的代码是上周的》改了 common 包的代码web 模块跑起来行为没有任何变化排查很久才想起来自己根本没 install。Maven reactor、SNAPSHOT 缓存、IDEA 的工作区解析三套规则混在一起又踩了一次坑。下期聊聊怎么确认自己运行的到底是哪个版本的代码。如果本文对你有帮助欢迎 点赞 ⭐ 收藏 关注 留言我是老炮Java 老兵仍在一线。关注「Java老炮踩坑录」看真实案例少踩坑。