集成环境 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中的版本号可能导致混淆和困惑。其他人可能无法正确地识别和使用你的项目。

相关推荐
Dnelic-9 小时前
【笔记】Android Gradle Plugin配置文件相关说明-libs.versions.toml
android·ide·笔记·gradle·plugin·版本控制
Winston Wood13 天前
一文了解git TAG
git·版本控制
Winston Wood18 天前
跟着Lydia小姐姐系统学习git命令(动画演示)
git·版本控制
蜗牛沐雨1 个月前
如何安装和使用 Git Large File Storage (LFS)
git·版本控制·git lfs
极客先躯2 个月前
高级java每日一道面试题-2024年10月3日-分布式篇-分布式系统中的容错策略都有哪些?
java·分布式·版本控制·共识算法·超时重试·心跳检测·容错策略
️7713 个月前
Git入门 -- 分支
git·版本控制·代码托管
小_爽3 个月前
版本控制基础理论
git·版本控制
_错错错4 个月前
Git 详解(原理、使用)
git·版本控制·协同开发
Amd7946 个月前
Django RESTful API设计与实践指南
性能优化·版本控制·实战项目·安全认证·部署策略·api 设计·django rest