依赖 jar 没有传递,导致找不到类文件而启动失败了
前言
最近频繁遇到找不到类文件错误。
Caused by: java.lang.NoClassDefFoundError:xxx
就这个家伙。
但是我本地启动服务是正常的,前前后后经历了
惊讶
-> 疑惑
-> 烦躁
-> 暴躁
-> 心塞
-> 欣喜
在短短的小半天内,感觉心情像过了一个过山车+大摆锤,结束了,脑袋都是晕的。
关键是本地是正常的!
![](https://static001.geekbang.org/infoq/42/4230f0abff7615a3294b0380bf847710.png)
现在,请跟随我的视角,来看看这个让人心态差点爆炸的异常吧!
遇到问题
在一顿噼里啪啦之后,代码写完,Junit 测试完毕、接口文档 Upload 到 YApi 完毕。果断发布 dev 环境!
直接进入启动重试!(PS:通过发布平台发布的)
这时候第一反应:本地启动一下试试!
本地正常啊!
肯定是我启动姿势不正确,重新发布一下!
![](https://static001.geekbang.org/infoq/b1/b18bbf11d4800987723e1e8044dcd359.jpeg?x-oss-process=image/resize,p_80/auto-orient,1)
实锤了,和启动姿势没关系!
从淡定到暴躁
当然是看启动日志了。
PS: 服务没起来,只能 ssh 到服务器看日志。
就这俩哥们,类找不到,奇了怪了。
这个类是通过三方 jar 包依赖进来的,我在 IDEA 里面 ⌘ + B
还能进入源码!
这我不禁怀疑是不是因为开发环境使用的 Docker 容器的原因。
发布其他分支,是可以的。
![](https://static001.geekbang.org/infoq/ce/cecd98e1c147ae548e31f1ef9985303a.png)
莫非就是因为我引入了一个其他小伙伴提供的 jar,导致我现在用不了!
又是一顿调整依赖!
还不行!
难道是我引入的引来版本不对?
从其他项目找一找怎么用的!
依然不行!
难道是他的 jar 包里面又依赖了很多其他的?
试着 exclusion
掉其他依赖!
依然不行!
是我本地 jar 缓存?
删除本地磁盘上的 jar 试试?
😠😠😠!
![](https://static001.geekbang.org/infoq/f6/f6605812503dc25abf5d39287c071769.png)
解决方案就在灵光一闪
虽然 dev 用的是容器,咱拉不下来 jar 包。但是我可以本地打个包试试!
clean package
得到一个 jar 包
进到 BOOT-INF/lib
里面
竟然啥也没有!
![](https://static001.geekbang.org/infoq/6f/6fe83c7e94ba25bee505e9fa8debf004.jpeg?x-oss-process=image/resize,p_80/auto-orient,1)
既然是打包没有打进去,那就看一下 mvn 依赖树的问题吧!
解决问题
![](https://static001.geekbang.org/infoq/d7/d7bee0c7a1912582bbe2d49ccb92c4fa.png)
web 启动失败,是因为 service 添加的依赖,没有传递到 web,所以 web 打包没有打进去那个类。
注意,这里可以正常打包,本地环境可以正常启动。
奇怪吧!
现在进入解决方式:
查看 maven 依赖树
进入到 web module,执行以下命令。
有这么一行错误:
问题描述的很清晰,依赖传递失败,因为啥依赖传递失败呢?
再开启 debug 打印下错误:
说是因为下面两个 jar 的 version 找不到,所以会导致依赖传递失败。
PS: 我所有的依赖版本都是在父 POM 进行维护的,子 module 只有依赖 groupId 和 artifactId。
所以归根到底,是因为父 POM 的版本没有传递下去!
仔细一瞅,发现父 POM 的版本是 1.0.0,各个 module 的 parent
节点的属性也是 <version>1.0.0</version>
。
之前都是 SNAPSHOT 版本,后来因为公司的 nexus 配置了自动清除长时间不用的 SNAPSHOT 版本的依赖,我就去掉了 SNAPSHOT。
父 POM deploy 到私服的就是一个空的项目,里面就一个 POM 文件。
最后升级了一下父 POM 的版本,重新 deploy 一下,再改改各个 module 的依赖版本。
大功告成!
总结
本文主要是含泪记下一个苦逼的问题排查过程。害,竟然没有第一时间想到原因!
![](https://static001.geekbang.org/infoq/58/588f6eb3d5397d55ecfc65b177d64913.gif)
下次再遇到记得 mvn -X dependency:tree>tree.txt
看下依赖树!
我的实践已经证明了:重启、清缓存、排除依赖都是没用的!
版权声明: 本文为 InfoQ 作者【程序员小航】的原创文章。
原文链接:【http://xie.infoq.cn/article/2502f19a3f5afae64937384bc】。
本文遵守【CC-BY 4.0】协议,转载请保留原文出处及本版权声明。
评论