Gradle构建processDebugResources耗时过长AAPT2超时问题解决方案

这是Android Gradle插件（AGP）在Debug构建阶段针对launcher模块执行的核心资源处理任务，全部逻辑由AAPT2（Android资源打包工具v2）执行，核心职责包括：

• 扫描模块自身res目录、所有依赖库传递引入的全部资源（布局、图片、字符串、主题、动画、菜单等），做语法、命名、引用合法性校验
• 将XML资源编译为二进制格式、对位图资源做尺寸/体积优化，生成扁平化的中间资源文件
• 全局分配资源ID、排查跨模块资源重名冲突、建立资源引用索引
• 生成对应构建变体的R类文件、未签名的资源APK中间包，供后续代码编译、APK拼接步骤使用
  你日志里提到的:launcher:bundleDebugResources是该任务的前置关联步骤，负责把所有编译完成的扁平化资源拼接为资源包，两个任务都直接依赖AAPT2守护进程执行。

你之前尝试的通用构建加速方案无效，核心原因是问题不是Gradle堆内存不够、缓存没开这类通用问题，而是AAPT2进程异常、畸形资源卡进程、或者对应版本AAPT2的已知平台Bug导致，按优先级从高到低尝试以下方案：

1. 定位卡死AAPT2的畸形资源（命中率90%以上） #

AAPT2守护进程无法正常关闭、处理速度骤降，绝大多数情况是遇到了无法正常解析的异常资源，不是配置问题：

• 先在项目根目录的gradle.properties文件中添加配置android.aapt2.legacyLogging=true，重新执行构建，控制台会打印AAPT2处理每一个资源的完整日志，直接定位到卡住的具体文件。常见触发问题的资源包括：
  • 单张体积超过3MB、未做压缩的PNG/WebP大图，尤其是放在drawable任意dpi目录下会触发AAPT2自动压缩逻辑的图
  • 文件名包含中文、空格、特殊转义字符的资源
  • 后缀与实际格式不匹配的图片（比如后缀标成.png实际是.jpg/.webp、文件头损坏的图片）
  • 嵌套层级超过10层、引用了不存在属性的矢量图/shape/selector类XML资源
• 定位到问题文件后，统一转成标准WebP格式、修正文件名、替换损坏文件即可解决。

2. 修正AAPT2守护进程配置 #

你日志里的30秒超时强制终止，本质是默认配置下AAPT2分配的内存不足、超时阈值设置过短，或者守护进程复用导致泄漏，在gradle.properties中添加/修改以下配置：

# 将AAPT2守护进程关闭超时从默认30秒调整为120秒，避免大资源量下正常关闭被误判超时
android.aapt2.daemon.shutdownTimeout=120000
# 给AAPT2单独分配2G堆内存，默认仅512M，资源量大时会频繁GC导致卡顿
android.aapt2.daemon.heapsize=2g
# 禁用AAPT2持久守护进程复用，每次构建启动全新进程，避免旧进程状态泄漏
android.aapt2.usePersistentDaemon=false

配置修改完成后，执行命令./gradlew --stop停掉所有存量Gradle、AAPT2守护进程，再重新发起构建。

3. 规避AGP 4.1.3绑定AAPT2的Mac平台已知Bug #

你所用的AGP 4.1.3版本绑定的aapt2-4.1.3-6503028-osx存在公开的MacOS兼容性Bug：在MacOS 12及以上版本运行时，会反复触发系统文件权限校验，资源处理速度仅为正常版本的1/10，且会随机出现守护进程无响应。不需要升级整个AGP版本，直接在模块级build.gradle中强制指定修复了该问题的AAPT2版本即可：

android {
    // 保留原有配置
    configurations.all {
        resolutionStrategy {
            force 'com.android.tools.build:aapt2:4.2.2-7147631'
        }
    }
}

4. 减少AAPT2无效处理开销 #

如果launcher模块引入了大量带冗余资源的三方SDK，可以开启Debug阶段的资源收缩，减少AAPT2需要扫描、处理的资源总量：

android {
    buildTypes {
        debug {
            shrinkResources true
            minifyEnabled false // Debug构建不需要开启代码混淆，不影响资源收缩生效
        }
    }
    aaptOptions {
        // 忽略res目录下不需要打包的非资源文件，减少扫描开销
        ignoreAssetsPattern '*.psd:*.zip:*.md:*.doc'
    }
}

注意：不要为了提速在Debug构建设置aaptOptions.cruncherEnabled = false，该开关会关闭图片合法性校验，虽然能缩短构建时间，但会掩盖资源格式问题，直到正式打包才会暴露。

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