多模块Maven子模块POM未部署Artifactory引发依赖缺失报错

异常表现梳理 #

• 部署完成后核对Artifactory存储：仅存在父模块mydomain（版本1.14.0-SNAPSHOT）的POM文件、子模块mydomain-model（版本1.6.1-SNAPSHOT）的Jar包，子模块对应版本路径下完全缺失匹配的POM文件
• 下游Spring Boot项目拉取依赖时，日志明确报出The POM for com.myorg.services:mydomain-model:jar:1.6.1-SNAPSHOT is missing, no dependency information available，后续因无法拉取传递依赖直接触发编译错误
• 部署阶段日志可佐证问题：所有上传动作里没有子模块POM的上传记录，仅推送了上述两类文件

常见触发原因与对应修复方式 #

• Deploy插件配置误开启POM跳过开关
  部分定制化构建配置里，maven-deploy-plugin可能被加上了<skipPom>true</skipPom>的配置，或者搭配JFrog Artifactory插件使用时，自定义的上传匹配规则仅筛选了.jar后缀的文件，把.pom文件排除在上传清单外。
  修复时需要逐行检查父POM、子模块POM里的Deploy插件与Artifactory插件配置，显式把skipPom设为false，并确保上传规则把所有模块生成的.pom文件纳入允许上传的范围。
• 父子模块版本不匹配导致的部署逻辑识别偏差
  当前项目配置里，父模块本身是packaging为pom的独立构件，而子模块没有复用父模块的版本号，单独定义了1.6.1-SNAPSHOT的版本，和父模块的1.14.0-SNAPSHOT版本不一致。部分Maven版本的部署逻辑在这种跨版本继承的场景下，会错误把子模块的POM归属判定为父模块的关联文件，不会单独为子模块的POM生成独立的上传任务，最终导致子模块Jar包能正常上传，但POM被遗漏。
  如果没有特殊的版本隔离需求，可以删掉子模块POM里单独定义的<version>字段，直接继承父模块的版本号；如果确实需要子模块独立版本，就在子模块POM里显式声明maven-deploy-plugin的部署目标，确保POM被纳入独立的构件上传清单。
• Artifactory侧路由/权限配置偏差
  对比日志发现，Jar包是被推送到libs-snapshot-local本地仓库，但下游拉取依赖时是从libs-snapshot虚拟仓库发起请求的。如果这个虚拟仓库的路由规则没有绑定libs-snapshot-local的POM文件路径权限，或者把.pom后缀的请求重定向到了其他没有对应文件的仓库，就会出现Jar包能正常拉取、POM拉取失败的问题。
  修复时需要核对虚拟仓库的路由绑定规则，确保libs-snapshot-local的所有路径都能被虚拟仓库正常索引，给构建服务账号开放对应路径的读写权限，避免出现文件存在但拉取被拦截的情况。

修复验证步骤 #

• 重新触发Maven部署流程，查看部署日志里的上传条目，确认子模块版本路径下的POM文件已经成功推送至Artifactory
• 清空下游项目本地Maven仓库里com/myorg/services/mydomain-model的缓存目录，重新触发Jenkins构建，确认不再出现POM缺失的告警，所有传递依赖可以正常解析拉取

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