Azure DevOps代理中Gradle无法访问Azure Artifacts报401如何解决？

• 核对仓库ID匹配性
  Gradle读取settings.xml凭证的前提是build.gradle/settings.gradle中声明的Azure Artifacts Maven仓库的id属性与settings.xml中标签的完全一致（大小写敏感），示例正确配置如下：

  maven {
      id 'xxx' // 此处id必须与settings.xml的server id完全相同
      url 'https://pkgs.dev.azure.com/xxx/_packaging/xx/maven/v1'
  }
  

  多数场景下401报错是因为漏写仓库id或id不匹配，导致Gradle未读取对应凭证。
• 修正Maven Authenticate任务配置
  • 确保Maven Authenticate任务执行顺序在Gradle构建任务之前
  • 任务配置中开启「提供对所有 feeds 的访问权限」选项，同时明确指定你使用的settings.xml路径
  • 进入对应Azure Artifacts feed的权限设置页，确认构建服务账号Project Collection Build Service (你的组织名)被授予「协作方」及以上权限
• 直接使用Gradle原生凭证注入（替代settings.xml方案）
  该方案绕过settings.xml读取逻辑，稳定性更高：
  1. 在Azure DevOps管道中新建秘密变量，存储具备「打包(读取)」权限的Azure DevOps PAT
  2. 在Gradle构建任务的环境变量中新增两个参数：

     ORG_GRADLE_PROJECT_azureArtifactsUser=devops
     ORG_GRADLE_PROJECT_azureArtifactsPat=$(你定义的PAT秘密变量名)
     

  3. 修改项目中Maven仓库配置：

     maven {
         url 'https://pkgs.dev.azure.com/xxx/_packaging/xx/maven/v1'
         credentials {
             username = project.property('azureArtifactsUser')
             password = project.property('azureArtifactsPat')
         }
     }
     

     Azure Artifacts Maven源校验仅验证PAT有效性，username可以填写任意非空值。
• 排查settings.xml路径与有效性
  • 确认settings.xml存放路径正确：Linux/macOS代理为~/.m2/settings.xml（注意.m2是隐藏目录，开头的点不能漏），Windows代理为%USERPROFILE%\.m2\settings.xml
  • 可在构建任务前加一步执行命令验证文件存在：Linux/macOS执行ls ~/.m2/settings.xml，Windows执行dir %USERPROFILE%\.m2\settings.xml
• 验证PAT有效性
  可以用curl命令本地验证你的凭证是否有效：

  curl -u 任意用户名:你的PAT "https://pkgs.dev.azure.com/xxx/_packaging/xx/maven/v1/com/xx/xxxxxx/yyyyyyyyy.pom"
  

  如果返回401则说明PAT权限不足，重新生成PAT时务必勾选「Packaging (Read)」权限，同时确认有效期未过期。

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