如何让Gradle/Maven在正式版未发布时下载指定-SNAPSHOT快照

没问题，这事儿我熟！针对你的CI/CD流程里「正式版发布前用快照版兜底」的需求，Gradle和Maven都有对应的配置方案，我给你拆解开来说清楚：

Maven 项目配置 #

Maven默认不会自动 fallback 到快照版，得通过仓库配置和依赖版本策略来实现需求：

1. 开启快照仓库的访问权限 #

首先要在pom.xml（或全局settings.xml）里给你的仓库配置快照支持，同时设置更新策略，让Maven主动检查快照更新：

<repositories>
    <repository>
        <id>internal-repo</id>
        <url>http://your-internal-repo-url/releases-and-snapshots</url>
        <!-- 允许拉取正式版 -->
        <releases>
            <enabled>true</enabled>
        </releases>
        <!-- 开启快照支持，每次构建都检查更新 -->
        <snapshots>
            <enabled>true</enabled>
            <updatePolicy>always</updatePolicy>
            <checksumPolicy>fail</checksumPolicy>
        </snapshots>
    </repository>
</repositories>

2. 实现「正式版不存在则用快照」的版本切换 #

你可以用Maven Profile来实现自动切换逻辑：通过检查本地仓库是否存在正式版JAR，不存在则自动切换到快照版本。

<properties>
    <!-- 默认使用正式版版本号 -->
    <target.lib.version>1.0.0</target.lib.version>
</properties>

<profiles>
    <profile>
        <id>use-snapshot-if-release-missing</id>
        <!-- 当本地仓库没有正式版JAR时自动激活 -->
        <activation>
            <file>
                <missing>${settings.localRepository}/com/your-team/your-lib/${target.lib.version}/your-lib-${target.lib.version}.jar</missing>
            </file>
        </activation>
        <!-- 切换到快照版本 -->
        <properties>
            <target.lib.version>${target.lib.version}-SNAPSHOT</target.lib.version>
        </properties>
    </profile>
</profiles>

<dependencies>
    <dependency>
        <groupId>com.your-team</groupId>
        <artifactId>your-lib</artifactId>
        <version>${target.lib.version}</version>
    </dependency>
</dependencies>

注意：如果远程仓库存在正式版但本地没有，Maven会先尝试下载正式版，失败后才会触发Profile切换到快照。

Gradle 项目配置 #

Gradle的版本解析逻辑更灵活，两种方式都能实现你的需求：

1. 配置快照仓库 #

先在build.gradle（Groovy DSL）里开启仓库的快照支持：

// Groovy DSL
repositories {
    maven {
        url = uri("http://your-internal-repo-url/releases-and-snapshots")
        content {
            includeGroup("com.your-team")
            releasesOnly() // 默认优先正式版
            snapshots()    // 允许拉取快照
        }
        // 每次构建都检查快照更新
        mavenContent {
            snapshots {
                updatePolicy = "always"
            }
        }
    }
}

2. 自动 fallback 到快照版的两种实现方式 #

方式一：自定义版本解析策略

通过resolutionStrategy实现「先试正式版，失败则用快照」的逻辑：

// Groovy DSL
configurations.all {
    resolutionStrategy {
        eachDependency { details ->
            def requested = details.requested
            // 只针对你的目标库生效
            if (requested.group == 'com.your-team' && requested.name == 'your-lib') {
                try {
                    // 尝试解析正式版
                    details.useVersion(requested.version)
                } catch (Exception e) {
                    // 正式版不存在，切换到快照版
                    details.useVersion("${requested.version}-SNAPSHOT")
                }
            }
        }
    }
}

dependencies {
    implementation 'com.your-team:your-lib:1.0.0'
}

方式二：动态版本 + 优先正式版

用Gradle的内置版本规则，声明固定版本后让它自动兜底到快照：

// Groovy DSL
dependencies {
    implementation 'com.your-team:your-lib:1.0.0'
}

configurations.all {
    resolutionStrategy {
        preferReleaseVersions() // 优先选择正式版
        // 当正式版不存在时，允许使用同版本号的快照
        enableDependencyVerification = false // 如果开启了依赖验证，需临时关闭或调整规则
    }
}

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