AAPT2守护进程超时关闭失败，Android项目重建报错求助

安全阿岳

2026-6-23

AAPT2守护进程超时关闭失败的解决方法

报错摘要

AAPT2 aapt2-8.4.0-11315950-windows Daemon #0 未能在超时内关闭
java.util.concurrent.TimeoutException: AAPT2 aapt2-8.4.0-11315950-windows Daemon #0: 未能在30秒内关闭，强制终止

解决步骤

清理项目缓存
执行Gradle清理与重建：在Android Studio中点击Build -> Clean Project，完成后再点击Rebuild Project。也可以通过终端运行命令：
```
./gradlew clean
./gradlew rebuild
```
手动删除项目根目录下的.gradle、build文件夹，以及app模块内的build文件夹，删除后重启项目重新构建。
延长AAPT2超时时间
在项目根目录的gradle.properties文件中添加配置，将守护进程超时时间调整为60秒（可按需修改）：
```
android.aapt2DaemonTimeout=60
```
禁用AAPT2守护进程
若超时问题频繁出现，可关闭守护进程模式（会略微降低构建速度），在gradle.properties中添加：
```
android.enableAapt2Daemon=false
```
排查资源文件错误
资源文件的语法错误、重复定义或格式问题可能导致AAPT2进程卡顿。检查XML布局、图片资源、字符串文件是否存在异常，修复后重新构建。
更新Gradle与AGP版本
确保Gradle和Android Gradle Plugin（AGP）版本与AAPT2兼容。在项目级build.gradle中更新AGP：
```
dependencies {
    classpath 'com.android.tools.build:gradle:8.4.0'
}
```
同时在gradle/wrapper/gradle-wrapper.properties中更新Gradle版本：
```
distributionUrl=https\://services.gradle.org/distributions/gradle-8.7-all.zip
```
终止残留AAPT2进程
打开Windows任务管理器，找到所有aapt2.exe进程并强制结束，之后重新启动项目构建。