Android Studio Flamingo版本Gradle构建失败：无法解析debugRuntimeClasspath

• 检查网络与镜像配置

  • 确认网络能正常访问Maven仓库，国内环境建议替换为阿里云镜像。修改项目根目录build.gradle的repositories块：

    repositories {
        maven { url 'https://maven.aliyun.com/repository/public/' }
        maven { url 'https://maven.aliyun.com/repository/google/' }
        mavenCentral()
        google()
    }
    

  • 关闭代理或VPN，这类工具常导致依赖下载失败

• 清理缓存并重新同步

  • 打开Android Studio的File > Invalidate Caches...，勾选Clear file system cache and local history后点击Invalidate and Restart重启软件
  • 删除项目根目录和app模块下的.gradle文件夹，再点击右上角的Sync Project with Gradle Files按钮重新同步

• 排查依赖声明问题

  • 打开app/build.gradle，检查dependencies块里的依赖是否有拼写错误、版本号是否有效，有些旧依赖已被移除，需要替换为可用版本
  • 注释掉最近新增的依赖，重新构建，确认是否是某一个依赖导致的问题

• 匹配Gradle与插件版本

  • 打开项目根目录build.gradle，确保Gradle插件版本和Gradle wrapper版本兼容。比如插件7.4.2对应Gradle7.5左右
  • 修改gradle/wrapper/gradle-wrapper.properties里的distributionUrl，指定稳定版本：

    distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-bin.zip
    

• 检查本地仓库权限

  • 确认本地Maven仓库（默认~/.m2/repository）有读写权限，避免因权限不足无法写入依赖
  • Windows系统右键仓库文件夹，通过属性 > 安全给当前用户添加完全控制权限；Linux/macOS执行sudo chmod -R 755 ~/.m2/repository

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