集成环境 ClassNotFound 分析与排查

项目场景:

最近项目在集成环境,经常会报 ClassNotFound 异常,

而在开发环境通过IDEA查看项目,类是不缺的


原因分析:

经过排查,发现是项目中引用的 API jar包更新了,但是集成环境却没有成功更新,所以在项目打包的时候报 ClassNotFound 异常。而没有更新的原因,则是因为虽然 API 更新了,但是其包的版本却没有变。

而对于Maven来说,在构建时,会在本地仓库中查找相应的依赖项。如果本地仓库中已经存在了一个相同版本号的包,Maven会直接使用该包,而不会主动去更新远程仓库获取新的包。只有当本地仓库中不存在相应版本号的包时,Maven才会去远程仓库下载最新的包


解决方案:

1. 清掉本地仓库

最简单粗暴的方法就是清除本地仓库,这样所有的包都会从远程仓库拉取到最新的,自然就能解决这个问题

2. 强制使用远程仓库

在Maven的setting.xml文件中,把本地仓库的设置(如下)去掉,这样构建就只能用远程仓库了

xml 复制代码
<settings>
    <localRepository>C:\Users\username\.m2\repository</localRepository>
</settings>

深入分析

其实问题的本质还是因为 API 的jar包明明更新了,但是其版本却没更新。

一般来说,版本会在这么几种情况下更新

  • 发布新的功能或修复bug:当开发团队在项目中添加了新的功能或修复了已知的bug时

  • 与其他系统的兼容性要求变化:如果项目依赖于其他系统或库,并且这些系统或库的版本发生了变化,可能需要更新项目的版本来保持与其兼容。这样可以确保在使用项目时不会出现问题或错误。

  • 项目的重要里程碑或发布版本:当项目达到重要里程碑或发布版本时,可以考虑更新版本号。这有助于区分不同版本的项目,并为用户提供更好的使用体验。

然而,目前项目的版本控制基本都在GIT中去维护,而对于POM文件的维护却疏忽了,导致代码一直在更新,但版本号却没更新,这对其使用者而言,是会有很大问题的,很可能导致这些问题

①依赖冲突:当其他模块或项目依赖于这个项目时,它们将根据pom文件中的版本号来确定使用的是哪个版本。如果项目版本没有更新,可能会导致依赖冲突或无法使用最新的特性或修复。

③发布问题:如果你打算将项目发布到远程仓库或共享给他人使用,不更新pom中的版本号可能导致混淆和困惑。其他人可能无法正确地识别和使用你的项目。

相关推荐
没有bug.的程序员13 天前
Git 高级进阶:分支管理模型内核、Rebase 物理重塑与版本控制协作深度实战指南
java·git·分支管理·版本控制·rebase
艺杯羹19 天前
Git版本控制深度复盘:从入门到精通的完整指南
git·wpf·版本控制·git学习·git复盘
艺杯羹1 个月前
Git文件状态管理:从基础到进阶的完整指南
大数据·git·elasticsearch·版本控制·git教程·代码管理·git基础
Q741_1471 个月前
Git 基础操作速查手册 场景模拟
git·学习·版本控制·总结
艺杯羹1 个月前
Git入门基础:从概念到安装的完整指南
git·elasticsearch·开发工具·版本控制·git入门·代码托管
论迹1 个月前
【Git】-- 分支管理
git·ubuntu·版本控制
2503_946971862 个月前
【DataRecovery/GitOps】2026年度全量数据回滚与多重宇宙版本控制基准索引 (Phase 3-End & Phase 4-Start)
网络安全·系统架构·云计算·数据集·版本控制
遇见火星2 个月前
Git 入门指南:从零开始掌握版本控制的魔法
git·版本控制
realhuizhu2 个月前
你的Git提交记录是“代码史诗”,还是“只有上帝能看懂的天书”?
git·版本控制·团队协作·ai工具·提示词工程
BestOrNothing_20153 个月前
Git分支实操指南:本地学习分支创建+远程同步避坑全解析
git·分支管理·版本控制·开发规范·新手教程