如何配置Gradle Maven发布：仅稳定版本更新maven-metadata.xml

问题核心原因 #

你使用的是Artifactory通用仓库而非专用Maven仓库，Artifactory对Maven元数据的处理逻辑和Maven仓库不同：通用仓库会在每次部署时自动生成/更新根目录的maven-metadata.xml，无视Gradle生成的元数据文件或快照版本标识，这就是你之前的方案无效的根本原因。

有效解决方案 #

1. 配置Artifactory部署规则（推荐） #

在Artifactory仓库的Deployment Settings中添加规则，仅允许稳定版构建更新maven-metadata.xml的latest字段：

• 进入Artifactory仓库配置，找到Deployment Rules
• 添加规则：
  • 条件：Path匹配你的稳定版版本格式（比如*/com/yourgroup/yourartifact/[0-9]+\.[0-9]+\.[0-9]+/*）
  • 动作：Allow Update Maven Metadata
• 再添加一条规则，针对开发/分支构建：
  • 条件：Path匹配*/com/yourgroup/yourartifact/*-SNAPSHOT/*或包含分支标识的路径
  • 动作：Skip Update Maven Metadata

2. 拆分发布路径 #

将稳定版和开发版发布到通用仓库的不同子路径，让Artifactory分别维护各自的maven-metadata.xml：
修改Gradle发布配置：

publishing {
    repositories {
        maven {
            // 根据构建类型选择发布路径
            val baseUrl = "artifactory-url"
            val repoUrl = if (project.hasProperty("isRelease")) {
                "$baseUrl/releases"
            } else {
                "$baseUrl/snapshots"
            }
            url = uri(repoUrl)
            credentials(PasswordCredentials::class)
        }
    }
    publications {
        create<MavenPublication>("mavenCatalog") {
            from(components["java"])
        }
    }
}

执行发布时，稳定版添加参数：

gradle -PisRelease=true -Pversion=1.0.0 publish

开发版直接执行：

gradle -Pversion=1.0.0-dev.1 publish

这样releases路径下的maven-metadata.xml只会被稳定版更新，snapshots路径下的元数据不影响正式版的latest指向。

3. 自定义Gradle发布的元数据属性 #

在Gradle中为开发版构建添加自定义属性，让Artifactory识别并跳过元数据更新：

publishing {
    publications {
        create<MavenPublication>("mavenCatalog") {
            from(components["java"])
            // 为非发布构建添加标识属性
            if (!project.hasProperty("isRelease")) {
                pom.properties.set(mapOf("artifactory.skip-metadata" to "true"))
            }
        }
    }
    // 仓库配置保持不变
}

然后在Artifactory的Metadata Settings中，设置当pom.properties包含artifactory.skip-metadata=true时，跳过元数据更新。

为什么之前的方案无效 #

• 快照版本：通用仓库不区分Maven快照和正式版的元数据逻辑，依然会统一更新根目录的maven-metadata.xml
• 禁用GenerateModuleMetadata：该任务生成的是Gradle模块元数据（module.json），而非Maven的maven-metadata.xml，后者是Artifactory自动生成的，所以禁用无效
• skip-metadata URL参数：该参数仅对Artifactory的专用Maven仓库生效，通用仓库不识别此参数

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