Gradle依赖锁定：Jenkins与本地解析不一致问题排查

核心原因推测 #

1. 仓库配置不一致：本地与Jenkins使用的Maven仓库（或镜像）存在差异，Jenkins的仓库未同步到ch.randelshofer:fastdoubleparser:0.8.0等依赖，或者仓库元数据不完整，导致依赖解析时无法找到传递依赖。
2. 依赖锁定文件的环境适配问题：依赖锁定文件在本地生成，本地仓库能完整解析所有依赖，但Jenkins的仓库环境无法满足锁文件中的依赖要求，导致解析失败。
3. BOM解析逻辑差异：Jenkins环境中Gradle对JUnit BOM的处理与本地不同，可能是仓库元数据中BOM的优先级更高，或者Spring Boot依赖管理在不同环境下的解析逻辑有细微差异，导致依赖树结构变化。

具体解决方案 #

1. 对齐仓库配置 #

确保Jenkins构建环境的Gradle/Maven仓库配置与本地完全一致：

• 检查项目根目录的settings.gradle，确认所有仓库声明（如mavenCentral()、私有仓库）在Jenkins环境中都能访问。
• 如果Jenkins使用内部镜像仓库，联系仓库管理员确认ch.randelshofer:fastdoubleparser:0.8.0、org.junit:junit-bom:5.9.3、org.apiguardian:apiguardian-api:1.1.2已同步到镜像。

2. 在Jenkins环境重新生成依赖锁定文件 #

依赖锁定文件需要适配当前环境的仓库状态，在Jenkins agent上执行以下命令更新锁文件：

./gradlew dependencies --write-locks

提交更新后的锁文件到代码仓库，重新触发构建。

3. 彻底清理Jenkins的Gradle缓存 #

执行构建时添加参数强制清理缓存，避免旧缓存干扰：

./gradlew clean build --no-build-cache --no-daemon --refresh-dependencies

也可手动删除Jenkins agent上的Gradle缓存目录（默认路径：~/.gradle/caches）。

4. 验证依赖的可访问性 #

在Jenkins服务器上手动测试依赖是否能正常拉取，例如：

# 测试fastdoubleparser是否可访问
curl -I https://repo1.maven.org/maven2/ch/randelshofer/fastdoubleparser/0.8.0/fastdoubleparser-0.8.0.pom

如果返回200 OK说明仓库可访问；如果返回4xx/5xx，则需要排查仓库网络或权限问题。

5. 检查依赖解析策略 #

查看项目build.gradle中的resolutionStrategy配置，确认是否存在针对这些依赖的排除、强制版本等规则，且该规则在本地和Jenkins环境中一致：

configurations.all {
    resolutionStrategy {
        // 检查是否有异常的依赖规则
    }
}

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