使用Gradle Publish发布至Azure Artifact遇多错误求助

1. 解决PKIX证书路径构建失败问题 #

Java虚拟机未信任Azure DevOps的SSL证书，导致无法建立安全连接：

• 正式解决方案：
  1. 用浏览器打开Azure仓库URL，点击地址栏锁图标，导出SSL证书为.crt格式。
  2. 使用keytool将证书导入Java信任存储：

     keytool -importcert -file /path/to/azure-cert.crt -keystore $JAVA_HOME/jre/lib/security/cacerts -alias azure-devops-cert
     

     （JDK 9+路径为$JAVA_HOME/lib/security/cacerts，默认密码为changeit）
• 临时测试方案（不推荐生产环境）：
  在Gradle仓库配置中添加禁用证书校验的配置：

  maven {
      url 'https://azuredevops.url/organization-name/project-name/_packaging/artifact/maven/v1'
      name 'name'
      authentication {
          basic(BasicAuthentication)
      }
      allowInsecureProtocol = true
  }
  

2. 解决403 Forbidden权限问题 #

认证配置不匹配或权限不足导致：

• 确保Gradle仓库的id与settings.xml中<server>的<id>完全一致，修改Gradle仓库配置：

  maven {
      url 'https://azuredevops.url/organization-name/project-name/_packaging/artifact/maven/v1'
      id 'id' // 必须和settings.xml里的server id相同
      name 'name'
      authentication {
          basic(BasicAuthentication)
      }
  }
  

• 检查Azure DevOps个人访问令牌（PAT）：需授予**Packaging (Read & Write)**权限，且作用域覆盖目标项目。
• 确认settings.xml路径为${user.home}/.m2/settings.xml，文件无语法错误（移除多余的反引号，确保XML格式正确）。

3. 解决MavenInvalidFilenameException（maven-metadata.xml文件名异常） #

发布的构件信息不符合Azure Artifacts的Maven规范：

• 检查Gradle发布配置，确保artifactId、groupId、version配置正确且无特殊字符：

  publishing {
      publications {
          mavenJava(MavenPublication) {
              from components.java
              groupId = "your.group.id"
              artifactId = "artifact-name" // 需与报错中要求的artifactId一致
              version = "1.0.0"
          }
      }
      repositories {
          // 你的Azure仓库配置
      }
  }
  

• 确认Azure仓库URL中的Feed名称拼写正确：URL中_packaging/后的部分是你的Feed名称，需与Azure DevOps中创建的Feed完全一致。
• 清理本地缓存：删除${user.home}/.gradle/caches目录，执行gradle clean publish重新发布。

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