如何在POM.xml中配置自定义仓库凭证解决Maven依赖拉取错误

运行mvn clean package时遇到以下错误：

Could not transfer metadata io.smkfdk7.commons:commons-utils/maven-metadata.xml from/to custom-repo

由于Azure DevOps流水线配置settings.xml需要时间，可暂时通过在POM.xml中直接添加私有仓库custom-repo的登录凭证来解决问题，具体操作如下：

操作步骤 #

1. 在POM.xml的<project>根节点下添加<servers>节点，将私有仓库的用户名和密码与仓库ID绑定（必须和<repositories>中custom-repo的id完全一致）：

<servers>
    <server>
        <id>custom-repo</id>
        <username>${custom-repo-username}</username>
        <password>${custom-repo-password}</password>
    </server>
</servers>

2. 你已经在<properties>中定义了凭证变量，直接引用即可。如果需要默认激活该配置，可将custom-repo-auth profile的<activeByDefault>设为true；也可以运行Maven命令时手动指定profile：mvn clean package -Pcustom-repo-auth

修改后的完整POM关键部分示例 #

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
  <!-- 原有内容保持不变 -->
  
  <!-- 添加servers节点 -->
  <servers>
      <server>
          <id>custom-repo</id>
          <username>${custom-repo-username}</username>
          <password>${custom-repo-password}</password>
      </server>
  </servers>

  <repositories>
      <!-- 原有仓库配置不变 -->
  </repositories>

  <!-- 其他原有内容不变 -->
  
  <profiles>
      <profile>
          <id>custom-repo-auth</id>
          <activation>
              <!-- 设置为true默认激活该profile -->
              <activeByDefault>true</activeByDefault>
          </activation>
          <repositories>
              <!-- 原有仓库配置不变 -->
          </repositories>
      </profile>
  </profiles>

  <properties>
      <!-- 原有属性不变 -->
      <custom-repo-username>PID7552</custom-repo-username>
      <custom-repo-password>bvdbhsdvhfbvhfbvbfvhfhjfhfvbdfbvhfvh</custom-repo-password>
  </properties>
</project>

注意事项 #

• 这只是临时解决方案，硬编码凭证在POM中存在安全风险，后续务必迁移到Azure DevOps流水线的安全变量或settings.xml文件中（推荐使用流水线变量注入，避免代码中暴露敏感信息）。
• 必须保证<server>的id与<repository>的id完全匹配，否则Maven无法关联凭证。

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