安装Android SDK Build-Tools后构建仍提示找不到30.0.3及以上版本构建工具怎么办

异常原因 #

• 你当前使用的Android Gradle Plugin（AGP）版本无法正确识别预览版Build Tools的版本命名规则，32.0.0-rc1这类带rc后缀的预发布版本号，会被版本校验逻辑判定为不符合「30.0.3及以上正式版」的要求
• 环境变量配置中未将build-tools目录加入PATH，部分构建场景需要从全局路径调用Build Tools组件
• 项目模块级build.gradle没有显式指定buildToolsVersion参数，AGP默认会搜索适配的正式版Build Tools，找不到对应版本就会抛出异常
• 可能存在ANDROID_HOME路径配置不生效的问题，导致构建工具无法定位到SDK目录

解决步骤 #

1. 先验证环境变量路径是否正确，终端执行命令echo $ANDROID_HOME，确认输出路径和你本地SDK路径~/Library/Android/sdk完全一致
2. 安装正式版Build Tools避免版本识别问题：打开SDK Manager的SDK Tools页，勾选「Show Package Details」，找到Android SDK Build-Tools分类下的30.0.3、31.0.0这类不带rc后缀的正式版本，选中安装即可
3. 补全环境变量配置：打开你当前使用的shell配置文件（如果是zsh则是~/.zshrc，如果是bash则是~/.bash_profile），在原有ANDROID_HOME配置后新增一行：

export PATH=${PATH}:${ANDROID_HOME}/build-tools/31.0.0

保存后终端执行source ~/.zshrc（替换为你实际的配置文件名）使配置生效
4. 在模块级build.gradle的android代码块中显式指定Build Tools版本，示例配置：

android {
    compileSdk 32
    buildToolsVersion "31.0.0" // 版本和你安装的正式版Build Tools保持一致
    // 剩余原有配置保持不变
}

5. 同步Gradle配置后重新构建项目即可

内容的提问来源于stack exchange，提问作者Raz Buchnik