macOS下Android Studio Arctic Fox构建报Could not find tools.jar错误求助

解决方案 #

问题根源 #

你当前默认使用的/Library/Internet Plug-Ins/JavaAppletPlugin.plugin/Contents/Home是浏览器使用的JRE运行环境，并非完整JDK，天生不包含构建需要的tools.jar，同时你的配置存在路径空格未转义、配置文件名拼写错误的问题。

具体操作步骤 #

方案一：使用Android Studio内置JDK（推荐，最稳妥）

Arctic Fox及以上版本的Android Studio自带适配的完整JDK，无需额外配置外部JDK：

• 打开Android Studio，进入 Android Studio > Preferences（Windows为File > Settings）
• 依次找到 Build, Execution, Deployment > Build Tools > Gradle
• 在Gradle JDK下拉选项中选择 Embedded JDK (recommended)
• 删除项目根目录gradle.properties文件中手动添加的org.gradle.java.home相关配置行，避免自定义配置覆盖AS设置
• 重新执行构建即可

方案二：配置外部JDK

如果需要使用自己安装的外部JDK，按以下操作配置：

• 下载安装官方完整版JDK 8，安装完成后路径会自动生成在/Library/Java/JavaVirtualMachines/目录下
• 编辑~/.zshrc文件，替换之前的JAVA_HOME配置为以下内容（路径带空格必须用引号包裹避免解析错误）：

export JAVA_HOME="$(/usr/libexec/java_home -v 1.8)"
export PATH="$JAVA_HOME/bin:$PATH"

• 执行source ~/.zshrc生效配置（注意你之前拼写错误写成了~/.zscrc，导致配置未生效）
• 执行ls $JAVA_HOME/lib/tools.jar验证，能正常输出文件路径即为配置成功
• 重新执行构建即可

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