Maven多模块项目运行时依赖异常：模块2加载模块1旧快照依赖引发方法不存在报错

这种Maven多模块的快照依赖坑我也踩过好几次！结合你的描述，本质是Maven快照依赖的缓存机制和多模块构建的依赖解析顺序导致的问题——明明本地刚构建了最新的module1，但module2运行时却偷偷拉取了Nexus或本地.m2里的旧module1快照，进而带上了过时的依赖版本，最终触发运行时方法找不到的错误。

问题根源拆解 #

Maven的快照依赖解析逻辑默认是为了提升构建速度，不会每次都去仓库拉取最新的快照版本，而是会优先使用本地或远程仓库的缓存快照。当你在多模块项目里更新了module1的依赖，但没有正确触发快照更新时，module2在解析依赖时可能会跳过本地刚构建的module1，转而使用缓存的旧快照，导致运行时类路径混入过时的依赖。

一步步解决方案 #

1. 强制更新快照+全量构建项目
   这是最直接的修复方式，用-U参数强制Maven更新所有快照依赖，同时全量构建多模块项目，确保module2依赖的是最新构建的module1：

   mvn clean install -U
   

   • clean：彻底删除各模块的target目录，清除旧的构建产物
   • install：将最新的module1安装到本地.m2仓库，让module2能直接引用本地最新版本
   • -U：强制Maven检查并更新所有快照依赖，避免使用缓存的旧版本

2. 清理本地仓库的旧快照
   如果本地.m2里的旧module1快照缓存顽固残留，可以手动删除对应目录：
   比如你的module1坐标是com.example:module1:1.0-SNAPSHOT，就删除~/.m2/repository/com/example/module1/1.0-SNAPSHOT目录，然后重新构建。

3. 配置Maven快照仓库的更新策略
   为了避免后续再出现类似问题，可以在你的settings.xml里配置快照仓库的更新策略为always，让Maven每次构建都检查最新的快照：

   <settings>
     <profiles>
       <profile>
         <id>snapshot-repo</id>
         <repositories>
           <repository>
             <id>nexus-snapshots</id>
             <url>http://your-nexus-url/repository/snapshots/</url>
             <snapshots>
               <enabled>true</enabled>
               <updatePolicy>always</updatePolicy> <!-- 强制每次更新快照 -->
             </snapshots>
           </repository>
         </repositories>
       </profile>
     </profiles>
     <activeProfiles>
       <activeProfile>snapshot-repo</activeProfile>
     </activeProfiles>
   </settings>
   

4. 验证依赖树+排查来源
   运行以下命令查看module2的依赖树，确认commons-lang3的来源是否为本地最新的module1，而不是旧的快照：

   mvn dependency:tree -Dverbose -Dincludes=org.apache.commons:commons-lang3
   

   输出里如果显示[INFO] +- com.example:module1:jar:1.0-SNAPSHOT:compile下的commons-lang3是你更新后的版本，就说明依赖解析正常了。

5. IDE缓存排查（如果是IDE运行时出问题）
   如果你是在IDE（IntelliJ/Eclipse）里运行项目，可能IDE缓存了旧的依赖：

   • IntelliJ：点击Maven工具窗口的Reload All Maven Projects，然后执行File -> Invalidate Caches...并重启IDE
   • Eclipse：右键项目 -> Maven -> Update Project...，勾选Force Update of Snapshots/Releases

为什么会出现“看起来依赖本地module1，但运行时用了旧依赖”的现象？ #

这是因为Maven在构建module2时，如果本地或远程仓库存在module1的快照，且没有触发强制更新，Maven会优先使用仓库里的快照（即使本地多模块里有最新的module1）——这是Maven的依赖解析优先级规则：仓库快照 > 本地项目模块（除非你用-am/-amd参数指定构建依赖模块）。而mvn clean install在多模块项目里会按依赖顺序构建，同时将最新模块安装到本地仓库，这样就能覆盖旧的快照。

内容来源于stack exchange