使用mvn deploy命令与Artifactory UI部署构件的差异是什么

核心差异 #

• Maven元数据生成逻辑差异
  mvn clean deploy 执行时会自动生成对应构件的maven-metadata.xml元数据文件并同步上传，该文件记录了当前groupId:artifactId下所有可用版本、最新版本标识、更新时间等信息，是mvn versions:use-latest-versions命令判断新版本的核心依据。
  通过UI或curl手动上传Jar时，Artifactory默认不会立即生成或更新对应目录的maven-metadata.xml，元数据重构存在延迟，也不会主动触发上传，因此Maven拉取到的仍是旧版元数据，无法识别新上传的构件。
• 上传文件完整性差异
  mvn clean deploy 除Jar包外，会同步上传对应版本的.pom文件、校验和文件（.sha1/.md5），配置了源码/文档插件的项目还会同步上传对应附属包，完整的文件结构是Maven判定构件合法的必要条件。
  手动上传如果只上传Jar包、未上传对应.pom文件，Maven会直接判定该构件无效，不会纳入版本候选范围。
• 仓库索引更新差异
  mvn deploy 完成后会自动触发Artifactory对应仓库的实时索引更新，而手动上传的索引更新存在固定的时间间隔延迟，未更新的索引也会导致版本查询命令无法识别新构件。

修复方案 #

• 手动上传时必须同步上传对应版本的.pom文件
• 手动上传完成后，进入Artifactory对应仓库的管理页，手动触发「重建元数据」操作，完成后再执行版本更新命令
• 执行版本更新命令时添加-U参数，强制Maven拉取最新远程元数据，忽略本地缓存，示例命令：
  mvn versions:use-latest-versions -U

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