Maven私有仓库依赖异常：运行时出现NoClassDefFoundError求助

先梳理下你遇到的核心矛盾：编译阶段能通过说明Maven确实拉到了依赖的编译产物，但运行时找不到类，结合你提到的两个事件，咱们一步步来排查：

1. 检查私有仓库依赖的Maven范围（Scope） #

首先确认你项目中那些私有仓库依赖的<scope>配置是否正确：

• 如果依赖是运行时需要的，绝对不能设为provided或test——这两个范围的依赖只会在编译/测试阶段生效，运行时不会被打包进项目。
• 打开你的pom.xml，找到对应的依赖项，确保<scope>是默认的compile（可以不写，默认就是compile）；如果是仅运行时才需要的依赖，设为runtime即可。

2. 验证本地构建的私有仓库依赖是否完整 #

你提到现在必须手动本地构建私有仓库的项目，那要确认你本地安装的依赖包是否包含了所有必要的类：

• 找到.m2/repository中对应私有依赖的目录，打开对应的.jar文件（用普通解压工具就行），检查里面是否存在报错提示的那个类。
• 如果类不存在，说明你本地构建私有项目时可能出了问题：比如构建时跳过了某些模块？或者私有项目的pom.xml配置有问题，导致编译后的jar包不完整。重新运行私有项目的mvn clean install -U，仔细看日志有没有报错，确保所有模块都正常构建并安装到本地仓库。

3. 检查IntelliJ的运行配置与依赖缓存 #

因为你误删过整个模块，IDE的运行配置或缓存很可能出了问题：

• 重新导入Maven项目：在IntelliJ中右键点击项目根目录 → Maven → Reload Project，让IDE重新读取最新的依赖配置。
• 检查运行配置的类路径：打开右上角运行按钮旁的下拉框 → Edit Configurations，切换到Classpath标签，查看里面是否包含了那些私有仓库的依赖jar包。如果没有，点击Add → Library，找到对应的Maven依赖添加进去。
• 彻底清理IDE缓存：点击File → Invalidate Caches...，选择Invalidate and Restart，清理掉IntelliJ的旧缓存后重启，再尝试运行项目。

4. 确认Maven私有仓库凭证的有效性 #

虽然你说更新了凭证且下载依赖正常，但还是要再确认细节：

• 打开settings.xml（一般在.m2目录下，或者IntelliJ配置的Maven路径下的conf目录），检查私有仓库的<server>配置，确保username和password是最新的，没有拼写错误或多余空格。
• 运行mvn dependency:tree命令，查看依赖树中是否正确拉取了私有仓库的依赖版本，有没有出现依赖冲突或者版本不一致的情况。

5. 检查打包配置（如果是打包后运行） #

如果你是把项目打包成jar/war后运行，那要确认打包插件是否包含了所有依赖：

• 如果用的是maven-jar-plugin，默认不会把依赖打包进去，这时候需要用maven-shade-plugin或者maven-assembly-plugin来构建可执行jar，确保所有依赖都被包含在最终的包中。
• 打开pom.xml的打包插件配置，检查是否正确配置了依赖打包的逻辑（比如shade插件的<transformers>是否正确设置）。

内容的提问来源于stack exchange，提问作者pauld