Android生产仓库Gradle构建失败排查：依赖无法解析问题

核心问题分析 #

从错误日志来看，构建失败的直接原因是无法从JCenter仓库拉取指定版本的依赖包，包括EasyFlipView-2.1.2、flexbox-2.0.1等。这些依赖的搜索路径均指向https://jcenter.bintray.com/，而JCenter早在2021年就停止新包上传，后续逐步转为只读状态，目前部分网络环境下已完全无法访问。

反常现象的根因推测 #

针对你提到的三个反常点，背后的原因可以拆解为：

1. 生产仓库未改动但突然报错：
   JCenter的可用性是逐步下降的，之前构建成功是因为本地Gradle缓存存在这些依赖，或者当时JCenter仍能访问。当缓存过期、被清理，或JCenter彻底无法访问时，未修改仓库配置的生产仓就会出现拉取失败。
2. 生产与开发仓依赖一致但开发仓正常：
   你提到开发仓重构了buildSrc为build-logic，大概率是这次重构中修改了仓库源配置（比如添加了MavenCentral、公司内部仓库，或移除了JCenter并替换为可用镜像），使得开发仓能从其他仓库拉取这些依赖，而生产仓仍依赖已失效的JCenter。
3. 仅部分同事遇到问题：
   • 成功构建的同事本地Gradle缓存中仍保留这些依赖，无需重新拉取；
   • 部分同事的全局Gradle配置（如init.gradle）中添加了其他可用仓库（比如MavenCentral），或网络环境能正常访问JCenter的残留节点；
   • 报错的同事可能清理过Gradle缓存、网络无法访问JCenter，或全局Gradle配置被修改为不包含JCenter。

排查步骤 #

按以下顺序逐一验证，定位具体根因：

1. 检查仓库配置差异 #

• 查看生产仓根目录build.gradle中的仓库配置，确认是否仅配置了JCenter，还是包含MavenCentral等其他仓库；
• 对比报错与成功同事的全局Gradle配置文件：
  • Linux/macOS路径：~/.gradle/init.gradle
  • Windows路径：C:\Users\<你的用户名>\.gradle\init.gradle
    检查是否有添加/移除仓库的逻辑，比如部分同事可能在开发仓工作时修改了全局配置，导致生产仓无法访问必要仓库。

2. 验证本地Gradle缓存 #

• 让报错的同事查看Gradle缓存目录：
  • Linux/macOS：~/.gradle/caches/modules-2/files-2.1
  • Windows：C:\Users\<你的用户名>\.gradle\caches\modules-2\files-2.1
    检查是否存在对应依赖的文件夹（比如com.wajahatkarim3.EasyFlipView/EasyFlipView/2.1.2）。如果不存在，说明缓存未命中，需要从仓库拉取但JCenter不可用；
• 对比成功同事的缓存目录，确认他们是否已缓存这些依赖。

3. 排查网络环境 #

• 让报错的同事尝试直接访问错误日志中的JCenter URL（比如https://jcenter.bintray.com/com/wajahatkarim3/EasyFlipView/EasyFlipView/2.1.2/EasyFlipView-2.1.2.aar），看是否能正常下载：
  • 若无法访问，说明网络存在限制（公司防火墙屏蔽、DNS解析失败等）；
  • 若能访问，可能是Gradle配置中的仓库优先级问题。

4. 检查Gradle/AGP版本差异 #

• 对比报错与成功同事的Gradle版本（查看gradle/wrapper/gradle-wrapper.properties中的distributionUrl）和Android Gradle Plugin（AGP）版本（根build.gradle中的com.android.tools.build:gradle版本）；
• 新版本的Gradle/AGP会对废弃仓库（如JCenter）做更严格的处理，可能自动跳过JCenter导致依赖拉取失败。

5. 确认开发仓build-logic的影响 #

• 检查开发仓的build-logic模块，是否有修改全局仓库配置的逻辑（比如通过共享的settings.gradle或gradle.properties）；
• 部分同事可能在开发仓工作时，将这些配置同步到了全局，导致生产仓构建时继承了新的仓库规则，而另一部分同事未同步。

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