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

相关推荐
玄芯散人4 天前
【金丹·65】ELF文件解剖:一个可执行文件里有什么
版本控制
我命由我123455 天前
Git 推送报错:error: src refspec main does not match any
运维·git·gitee·github·运维开发·学习方法·版本控制
玄芯散人6 天前
【筑基·058】Git协作工作流:冲突解决和PR流程
git·版本控制·团队协作
寺中人6 天前
Git 版本控制完全入门指南:从安装到实战,提交 + 分支 + 协作 + 冲突解决全拆解
git·开发工具·版本控制·团队协作·代码管理
玄芯散人6 天前
【筑基·057】Git代码时光机:版本控制入门到分支管理
git·版本控制·嵌入式开发
龙智DevSecOps解决方案7 天前
Perforce P4 2026 更新详解:P4 MCP 服务器、REST API、Spark Stream 与 P4 Signals
人工智能·devops·版本控制·p4·perforce
lingran__23 天前
Git 完全指南(二):分支管理
git·分支管理·版本控制·团队协作·多人开发·git flow
七夜zippoe24 天前
DolphinDB 2.0 配置管理实战:配置中心与版本控制落地指南
版本控制·配置中心·配置管理·dolphindb
lingran__24 天前
Git 完全指南(一):本地仓库基础操作
linux·git·开发工具·devops·版本控制
帅次1 个月前
Git 常用命令汇总
git·软件工程·开发工具·版本控制·git教程·代码管理·git命令