Android Studio构建签名APK失败：报错com.android.build.gradle.internal.tasks.Workers$ActionFacade

任务 ':app:bundleProductionreleaseResources' 执行失败。
执行com.android.build.gradle.internal.tasks.Workers$ActionFacade时发生错误
AAPT2 aapt2-4.1.1-6503028-osx Daemon #0: 链接阶段出现意外错误，尝试停止守护进程。

1. 清理缓存与残留进程 #

• 终止所有Gradle守护进程，在android目录下执行命令：./gradlew --stop
• 清理项目构建缓存：./gradlew clean
• 清除全局Gradle缓存，macOS下默认路径为~/.gradle/caches，直接删除该目录下对应版本的缓存内容即可
• 清除React Native侧临时缓存：rm -rf node_modules && yarn install && rm -rf /tmp/metro-*

2. 强制指定兼容AAPT2版本 #

Android Gradle Plugin 4.1.1自带的AAPT2版本存在macOS下偶发链接异常的已知问题，可通过强制指定修复版AAPT2解决。
在项目android/build.gradle文件中添加如下配置：

allprojects {
    configurations.all {
        resolutionStrategy {
            force 'com.android.tools.build:aapt2:4.1.3-6503028'
        }
    }
}

3. 资源文件合规校验 #

即使仅修改JS代码，release构建时会触发全量资源校验，需确认资源文件符合安卓规范：

• 所有res目录下的资源文件名仅允许小写字母、数字、下划线，禁止大写、中文、特殊字符
• 排查res/values系列目录下的xml文件是否存在未闭合标签、语法错误
• 确认不存在同名不同格式的资源文件，例如同目录下同时存在icon.png和icon.webp

4. 兼容性降级备选方案 #

如果上述方案均不生效，可降级Android构建工具版本到经过RN 0.63.3验证的稳定组合：

• 修改android/build.gradle中Android Gradle Plugin版本为4.0.2
• 修改android/gradle/wrapper/gradle-wrapper.properties中Gradle版本为6.1.1

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