为何settings.xml与pom.xml无法引导Maven部署至Artifactory？

问题背景 #

在Mac上配置Maven指向本地Artifactory OSS仓库构建供应商代码：

• 已在Artifactory创建本地仓库和虚拟仓库
• 通过Artifactory的Generate Settings生成配置片段，~/.m2/settings.xml中的ID和加密密码配置正确
• Maven已能正常从Artifactory拉取依赖，但部署（deploy）操作始终将构件推送到本地磁盘路径，而非目标Artifactory地址：
  • 指定相对路径时，Maven提示Using local repository at 代码目录+指定路径
  • 指定根路径（以/开头）时，Maven提示Using local repository at /whatever
  • 尝试配置Artifactory的URL（https://localhost/artifactory/reponame）时，Maven会自动在URL前添加代码目录前缀，不符合预期

现有配置片段 #

pom.xml中的distributionManagement配置 #

<distributionManagement>
    <repository>
        <id>central</id>
        <name>LocalMac-releases</name>
        <url>https://localhost/artifactory/TBX</url>
    </repository>
    <snapshotRepository>
        <id>snapshots</id>
        <name>LocalMac-snapshots</name>
        <url>https://localhost/artifactory/TBX</url>
    </snapshotRepository>
</distributionManagement>

主settings.xml中的localRepository配置 #

<!-- localRepository
   | The path to the local repository maven will use to store artifacts.
   |
   | Default: ${user.home}/.m2/repository
  <localRepository>/path/to/local/repo</localRepository>
-->

核心疑问 #

localRepository与distributionManagement的组合配置肯定存在问题，到底遗漏了什么？

问题根源与解决步骤 #

1. 纠正概念混淆：localRepository和部署无关 #

localRepository是Maven在本地磁盘缓存依赖的路径，完全不影响远程仓库的部署目标。你之前修改这个配置或者使用-Dmaven.repo.local参数，都是在调整本地缓存位置，和部署到Artifactory没有关系。

2. 确保settings.xml的服务器ID与pom.xml完全匹配 #

Artifactory生成的配置片段包含<servers>节点，必须保证~/.m2/settings.xml中的服务器ID和pom.xml里distributionManagement的<id>严格一致，否则Maven找不到认证信息会自动 fallback 到本地部署：

<servers>
    <server>
        <id>central</id> <!-- 必须和pom中<repository>的id一致 -->
        <username>你的Artifactory用户名</username>
        <password>加密后的密码</password>
    </server>
    <server>
        <id>snapshots</id> <!-- 必须和pom中<snapshotRepository>的id一致 -->
        <username>你的Artifactory用户名</username>
        <password>加密后的密码</password>
    </server>
</servers>

3. 检查Artifactory仓库的部署权限 #

登录Artifactory控制台，确认你使用的账号拥有目标仓库（TBX）的Deploy/Deploy Cache权限，没有权限的话Maven会静默降级到本地存储。

4. 验证Maven命令正确性 #

确保执行的是mvn deploy命令，而非mvn install——后者仅会将构件安装到本地仓库，不会触发远程部署。

5. 确认Artifactory URL的可用性 #

• 在浏览器中打开https://localhost/artifactory/TBX，检查仓库是否正常可访问
• 如果使用自签名SSL证书，需要将证书导入Java信任存储，否则Maven会因SSL验证失败 fallback 到本地

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