Gradle无法拉取S3仓库最新版本问题排查及解决方法

最近在Jenkins Pipeline里碰到个棘手的Gradle问题，折腾了好一阵才解决，跟大家详细说说来龙去脉和解决办法：

问题现象 #

我们的流水线流程是：先把项目“A”发布到S3私有仓库，紧接着下一步要拉取项目“A”的最新版本来构建。明明S3仓库里已经成功上传了最新版（比如2.8.245），但Gradle却一直返回旧版本（2.8.239）。更奇怪的是，其他项目拉这个S3仓库的依赖都能拿到最新版，就这条流水线出问题。

排查过程 #

一开始完全摸不着头脑，直到重新梳理Gradle的执行生命周期才找到突破口：

• Gradle的核心执行顺序是：插件初始化阶段 → 配置阶段 → 执行阶段
• 我们代码里有个自定义扩展APPConfig{ version }，原本是在插件逻辑里直接读取这个版本值来处理依赖，但插件初始化阶段比配置阶段还早，这时候APPConfig里的版本值还没被正确加载，导致插件用了旧的版本号去解析依赖！

后来试着把读取版本的代码移到插件创建的任务里，结果又踩了新坑：Gradle的依赖评估是在配置阶段完成的，而任务执行是在后面的执行阶段，等任务里拿到正确版本时，依赖早就已经用旧版本评估完了，根本起不到作用。

解决方案 #

最后在dependencies脚本块里加了动态读取逻辑，确保依赖版本能在配置阶段后期正确获取到最新的APPConfig.version值，终于解决了问题：

1. 动态读取自定义扩展的版本值 #

把原本硬编码或者提前读取的版本号，改成在dependencies块里直接引用扩展值，确保配置阶段完成时能拿到正确的版本：

dependencies {
    implementation("com.example:projectA:${APPConfig.version}") {
        // 可选：如果需要强制Gradle跳过本地缓存，直接拉远程最新版
        resolutionStrategy.cacheChangingModulesFor(0, 'seconds')
    }
}

2. Jenkins Pipeline中强制刷新依赖 #

在流水线拉取项目“A”的步骤里，给Gradle命令加上--refresh-dependencies参数，强制Gradle去远程仓库校验最新版本，避免使用本地缓存的旧版本：

./gradlew assemble --refresh-dependencies

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