Gradle无法解析androidx.compose:compose-bom:2026.06.00问题排查

核心原因分析 #

1. 版本仓库同步延迟：官方BOM映射页的版本更新通常会比Google Maven仓库的实际上线时间提前，页面更新后仓库可能还在同步流程中，导致暂时无法拉取到该版本。
2. 仓库配置遗漏：Compose BOM仅发布在Google Maven仓库，若你的Gradle配置中未声明google()仓库，会直接导致依赖解析失败。
3. 本地缓存干扰：Gradle本地缓存的旧依赖索引可能未及时更新，无法识别新发布的版本。

排查与修复步骤 #

• 检查仓库配置：
  确认项目根目录的settings.gradle.kts（或settings.gradle）中已添加Google仓库：

  dependencyResolutionManagement {
      repositories {
          google()
          mavenCentral()
      }
  }
  

  若使用旧版Gradle结构，检查模块级build.gradle的仓库声明：

  repositories {
      google()
      mavenCentral()
  }
  

• 清理缓存并强制刷新依赖：
  执行以下命令清理本地Gradle缓存，强制重新拉取最新依赖索引：

  ./gradlew clean build --refresh-dependencies
  

  Windows环境执行：

  gradlew clean build --refresh-dependencies
  

• 验证版本实际可用性：
  若上述操作后仍无法解析，说明该版本尚未正式同步到仓库，暂时回退至2026.05.01版本，等待1-2天后再次尝试升级。
• 解决配置缓存错误：
  若出现配置缓存相关问题，可先临时禁用配置缓存（在gradle.properties中添加org.gradle.configuration-cache=false），待依赖解析正常后再重新启用。

内容的提问来源于stack exchange，提问作者Stanisław Olszak