运行Android项目报ANDROID_SDK_HOME相关错误如何解决？

问题根因 #

报错核心是两个问题叠加导致插件加载失败：

1. ANDROID_SDK_HOME环境变量配置错误，该变量已被Android官方弃用，且你错误将其指向了SDK根路径，不符合该变量原有的设计规则，触发AGP（Android Gradle Plugin）加载异常。
2. 你提供的app模块build.gradle存在结构错误，插件声明放在了buildscript块前面，导致Gradle无法找到对应的插件依赖，加载com.android.application插件失败。

分步解决方法 #

• 修正环境变量配置
  打开Windows系统环境变量设置面板，删除ANDROID_SDK_HOME变量。如果需要配置SDK路径，使用官方推荐的ANDROID_HOME变量，指向路径C:\Users\jupun\AppData\Local\Android\Sdk即可，配置完成后重启Android Studio或者命令行工具让配置生效。
• 修正build.gradle结构
  调整app/build.gradle的代码顺序，将buildscript和全局repositories块移到所有apply plugin声明的前面，修正后的开头结构如下，其余android、dependencies等原有代码保持不变即可：

  buildscript {
      repositories {
          jcenter()
          google()
      }
  
      dependencies {
          classpath 'com.android.tools.build:gradle:7.0.1'
          classpath "io.realm:realm-gradle-plugin:5.11.0"
          classpath 'com.google.gms:google-services:4.3.3'
          classpath 'com.google.firebase:firebase-crashlytics-gradle:2.3.0'
      }
  }
  
  repositories {
      mavenCentral()
      jcenter()
      google()
      maven { url 'https://maven.fabric.io/public' }
      maven {
          url "https://oss.sonatype.org/content/repositories/snapshots"
      }
  }
  
  apply plugin: 'com.android.application'
  apply plugin: 'com.google.firebase.crashlytics'
  apply plugin: 'realm-android'
  

• 校验Gradle版本兼容性
  打开项目根目录下的gradle/wrapper/gradle-wrapper.properties文件，确认Gradle分发版本和AGP 7.0.1匹配，要求Gradle版本为7.0.2及以上，示例配置如下：

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

• 清理缓存重新构建
  依次执行如下操作：
  1. 点击Android Studio菜单栏 File -> Invalidate Caches / Restart 重启IDE
  2. 重启完成后点击Build -> Clean Project，再执行Rebuild Project即可完成构建

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