Android Studio运行Java应用报AAPT2进程意外退出如何解决

问题复现场景 #

Android Studio 2021.2.1 新建Java项目，点击运行按钮后构建中断，抛出AAPT2 process unexpectedly exit. Error output:错误。
已执行无效操作：

• 升级Gradle版本，确认Gradle插件与Gradle版本匹配
• 将JAVA_HOME环境变量修改为Android Studio内置jre路径：C:\Program Files\Android\Android Studio\jre
  

按优先级执行以下排查步骤 #

1. 清理IDE缓存与构建残留 #

这是该报错最高频的解决方案：

• 顶部菜单栏选择 File > Invalidate Caches...
• 勾选Clear file system cache and Local History，点击Invalidate and Restart
• IDE重启后如果仍报错，手动删除项目根目录下的.gradle、.idea文件夹，以及app模块目录下的build文件夹，重新打开项目等待Gradle同步完成后再次尝试运行。

2. 排查资源文件异常 #

AAPT2为Android资源打包工具，无明确错误日志的进程退出多数由资源问题触发：

• 检查res目录下所有文件命名：必须为全小写，仅允许包含字母、数字、下划线，禁止出现大写字母、中文、空格、特殊字符
• 检查近期修改的XML文件（布局、drawable矢量图、values配置等），确认不存在标签未闭合、属性值拼写错误、引用不存在的资源ID的问题
• 排查损坏的图片资源：将res目录下的图片文件临时移出，逐个加回后触发构建，定位损坏的图片文件替换即可。

3. 终止残留AAPT2进程后重新同步 #

异常退出残留的AAPT2守护进程会导致新进程启动失败：

• 打开系统终端执行命令杀掉所有残留进程：
  Windows环境执行：

  taskkill /F /IM aapt2.exe
  

  Mac/Linux环境执行：

  pkill -f aapt2
  

• 回到IDE点击File > Sync Project with Gradle Files重新同步项目。

4. 修正Gradle配置项 #

打开项目根目录下的gradle.properties文件检查配置：

• 若存在android.enableAapt2=false配置直接删除，高版本Android Gradle插件已强制启用AAPT2，手动关闭会直接触发进程异常
• 新增配置给AAPT2分配足够内存，避免内存不足导致进程被系统杀掉：

  android.aapt2Options.additionalParameters = ['--max-heap-size', '1024m']
  

5. 校验SDK Build Tools完整性 #

• 打开SDK Manager，切换到SDK Tools标签页，确认已安装稳定版Android SDK Build-Tools，建议直接安装最新稳定版本
• 打开app模块下的build.gradle文件，确认buildToolsVersion配置值与已安装的Build-Tools版本号完全一致。

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