集成Google Places API时出现debugRuntimeClasspath依赖解析失败问题

核心错误Could not find com.google.android.libraries:places:places说明依赖解析时出现了坐标识别或仓库访问问题，按以下步骤逐一排查：

• 检查libs.versions.toml配置与引用逻辑
  你的libs.toml中group = "com.google.android.libraries.places"是正确的，但要确认模块级build.gradle.kts的依赖引用是否符合当前Gradle版本的约定：
  部分新版Gradle中，直接使用libs.places即可，无需额外的libraries层级。把依赖引用改成：

  dependencies {
      implementation(libs.places)
  }
  

  同时核对libs.toml的结构，确保没有语法错误：

  [versions]
  places = "3.4.0"
  
  [libraries]
  places = { group = "com.google.android.libraries.places", name = "places", version.ref = "places" }
  

• 强制确保google()仓库的优先级与可用性
  Google官方库必须从google()仓库拉取，jitpack.io无法提供。在项目级build.gradle.kts的repositories块中，将google()放在最前面：

  repositories {
      google()
      mavenCentral()
      maven { url = uri("https://jitpack.io") }
  }
  

  同时检查模块级build.gradle.kts是否没有覆盖仓库配置，导致google()仓库未被加载。

• 验证AGP与Gradle版本兼容性
  Places SDK 3.4.0要求Android Gradle Plugin(AGP)版本至少为7.0。打开项目级build.gradle.kts，确认AGP版本：

  plugins {
      id("com.android.application") version "7.4.2" apply false
      // 其他插件配置
  }
  

  若版本低于7.0，升级到兼容版本后重新同步。

• 彻底清理Gradle缓存并重建
  缓存损坏也会导致依赖解析异常，执行以下操作：

  1. 点击Android Studio菜单File -> Invalidate Caches...，勾选Invalidate and Restart重启IDE
  2. 删除项目根目录的.gradle文件夹和模块下的build文件夹
  3. 终端执行命令：

     # Mac/Linux
     ./gradlew clean build --refresh-dependencies
     # Windows
     gradlew.bat clean build --refresh-dependencies
     

• 跳过版本目录直接硬编码依赖测试
  暂时绕过libs.versions.toml，直接在模块级build.gradle.kts中添加依赖：

  dependencies {
      implementation("com.google.android.libraries.places:places:3.4.0")
  }
  

  若此方式能成功构建，说明问题出在版本目录的配置或引用逻辑上；若仍失败，重点排查网络/代理或仓库配置。

• 排查网络与代理问题
  若处于国内网络环境，需确保能访问Google Maven仓库：

  • 检查Android Studio的代理设置（File -> Settings -> System Settings -> HTTP Proxy）是否正确，避免拦截Google仓库请求
  • 尝试切换到手机热点等不受限制的网络环境后重新同步

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