使用Gradle发布到GitHub Packages时如何忽略409冲突错误

Gradle原生PublishToMavenRepository任务未提供直接忽略409冲突错误的配置项，可通过以下两种方案实现需求： #

方案1：开启任务失败忽略+异常过滤 #

该方案通过配置任务的错误处理逻辑，仅跳过409冲突相关的失败，其他错误正常抛出：

Groovy DSL 配置 #

tasks.withType(org.gradle.api.publish.maven.tasks.PublishToMavenRepository) {
    // 开启任务忽略单步失败
    ignoreFailures = true
    // 添加异常过滤逻辑，仅对409错误做静默处理
    doLast {
        if (state.failure != null) {
            def failureMsg = state.failure.message
            if (failureMsg?.contains("409 Conflict") || failureMsg?.contains("already exists")) {
                logger.warn("检测到重复构件，跳过冲突项，其余构件发布完成")
                state.rethrowFailure = false
            }
        }
    }
}

Kotlin DSL 配置 #

import org.gradle.api.publish.maven.tasks.PublishToMavenRepository

tasks.withType<PublishToMavenRepository> {
    ignoreFailures = true
    doLast {
        state.failure?.let { failure ->
            val msg = failure.message.orEmpty()
            if ("409 Conflict" in msg || "already exists" in msg) {
                logger.warn("检测到重复构件，跳过冲突项，其余构件发布完成")
                state.isRethrowFailure = false
            }
        }
    }
}

方案2：发布前预校验跳过已存在构件 #

该方案更稳妥，从根源上避免触发409错误：
在发布任务执行前，先查询对应构件的元数据地址是否存在，若存在则直接跳过发布任务。

// Kotlin DSL 示例配置
import org.gradle.api.publish.maven.tasks.PublishToMavenRepository

tasks.withType<PublishToMavenRepository> {
    val repoUrl = repository.url.toString()
    val pub = publication
    doFirst {
        // 拼接对应版本的maven-metadata.xml访问地址
        val metadataPath = "${pub.groupId.toString().replace('.','/')}/${pub.artifactId}/${pub.version}/maven-metadata.xml"
        val metadataUrl = java.net.URI.create("$repoUrl/$metadataPath").toURL()
        val conn = metadataUrl.openConnection() as java.net.HttpURLConnection
        conn.requestMethod = "HEAD"
        // 传入GitHub鉴权token
        conn.setRequestProperty("Authorization", "token ${providers.environmentVariable("GITHUB_TOKEN").get()}")
        if (conn.responseCode == 200) {
            logger.lifecycle("构件 ${pub.groupId}:${pub.artifactId}:${pub.version} 已存在，跳过发布")
            enabled = false
        }
    }
}

注意事项 #

• 仅正式版本（非SNAPSHOT）会触发GitHub Packages的409限制，SNAPSHOT版本默认允许覆盖无需额外配置
• 上述两种方案都只会跳过409冲突错误，权限不足、网络异常等其他错误仍会正常中断任务，避免出现未感知的发布失败

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