同一项目内Maven插件依赖引用失败问题咨询

问题本质 #

这是Maven的预期行为，并非Bug。Maven对插件依赖和普通依赖的解析时机存在核心差异：

• 普通依赖在项目构建的后期阶段（如编译、打包环节）才会被解析，此时同项目的依赖模块已完成构建，能被Maven正常识别。
• 插件依赖在Maven启动初期的插件解析阶段就会被加载，这时候同项目的依赖模块还未完成构建，也未安装到本地Maven仓库，因此Maven无法找到对应依赖，直接触发构建失败。

可行解决方案 #

1. 分阶段构建（最通用方案） #

先单独构建并安装依赖模块到本地仓库，再执行主项目的构建：

# 先安装目标依赖模块（替换为你的依赖模块名称）
mvn clean install -pl common -am
# 再构建整个项目
mvn clean install

CI环境中可将两条命令串联执行，确保依赖模块先就绪。

2. 依赖模块提前发布到内部仓库 #

如果是团队协作场景，将公共依赖模块提前发布到内部Maven私服（如Nexus、Artifactory），插件可直接从私服拉取依赖，无需本地安装。开发阶段需先将本地修改的依赖模块deploy到私服，再构建主项目。

3. 调整项目结构（长期优化方案） #

若频繁遇到此类问题，可考虑将插件依赖的公共代码抽离为独立项目，与当前多模块项目解耦，提前维护版本并发布，从根源上避免同项目内的依赖时序冲突。

补充说明 #

Spring Cloud Contract官方示例中也存在完全相同的场景，其文档明确要求先安装common模块再执行根目录构建，这也印证了这是当前Maven生态下的常规处理方式。目前暂无官方的“一键构建”方案能绕过这个限制，因为插件解析的生命周期优先级高于项目模块构建是Maven的核心设计逻辑。

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