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

相关推荐
lingran__2 天前
Git 完全指南(二):分支管理
git·分支管理·版本控制·团队协作·多人开发·git flow
七夜zippoe2 天前
DolphinDB 2.0 配置管理实战:配置中心与版本控制落地指南
版本控制·配置中心·配置管理·dolphindb
lingran__3 天前
Git 完全指南(一):本地仓库基础操作
linux·git·开发工具·devops·版本控制
帅次11 天前
Git 常用命令汇总
git·软件工程·开发工具·版本控制·git教程·代码管理·git命令
EXI-小洲13 天前
Pycharm 使用SVN进行拉取或提交 - SVN基本使用
svn·pycharm·版本控制
tianyu2341 个月前
Git 常用命令完整手册
git·版本控制·常用命令
天空'之城2 个月前
VS Code Git 工作树:告别频繁切分支,实现多分支并行开发实战方案
git·vscode·版本控制·嵌入式开发·开发效率·worktree·多分支管理
逻极3 个月前
Git 从入门到精通:版本控制协作实战指南
git·github·分支管理·版本控制
snowjlz3 个月前
鸿蒙版SVN来了!!!
git·svn·版本控制
龙智DevSecOps解决方案3 个月前
Perforce P4 2026 路线图全解析:底层架构突破、AI 赋能与 2025.2 核心更新
devsecops·版本控制·perforce·配置管理·龙智