Android Studio构建Gradle报错，build.gradle异常，重启无效求解决

问题描述 #

在Android Studio中执行Gradle构建时触发报错，同时build.gradle文件内显示配置/语法错误。已尝试重启Android Studio，问题未解决且未找到同类方案。

排查与解决步骤 #

• 校验build.gradle语法完整性
  逐行检查文件中的括号、引号、逗号是否完全配对，重点排查依赖声明、插件配置块（如android{}、dependencies{}），避免出现未闭合的大括号、多余标点或版本号格式错误。
• 执行项目同步与清理
  依次操作：File > Sync Project with Gradle Files，完成后执行Build > Clean Project，再重新尝试构建。
• 匹配Gradle与AGP版本兼容性
  确认项目使用的Gradle版本和Android Gradle Plugin（AGP）版本符合官方兼容要求，可通过修改项目根目录下的gradle-wrapper.properties（调整distributionUrl）和根级build.gradle（调整AGP版本）来适配。
• 清除缓存并重启
  执行File > Invalidate Caches...，勾选Clear file system cache and local history后重启Android Studio，消除缓存导致的异常。
• 检查依赖仓库配置
  若报错涉及依赖下载失败，检查本地Maven仓库路径是否正确，或在build.gradle中添加国内镜像源加速依赖获取：

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

• 查看完整错误堆栈
  打开Android Studio底部的Build面板，展开完整错误日志，定位具体报错行和触发原因（如重复依赖、权限缺失、SDK版本不兼容等）。

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