在Bamboo上构建Android项目时触发Aapt2Exception失败

我在Bamboo上构建Android项目时持续遇到资源文件找不到的问题，尝试过相关解决方案但均无效，具体报错如下：

:app:mergeIt2Resources 09-May-2018 21:00:33 C:\Windows\System32\config\systemprofile.gradle\caches\transforms-1\files-1.1\play-services-base-15.0.1.aar\8bd8dfdd2cf63cd839f54537b3cca1ce\res\drawable-xxhdpi-v4\common_google_signin_btn_icon_light_normal_background.9.png: error: file not found.
09-May-2018 21:00:33 C:\Windows\System32\config\systemprofile.gradle\caches\transforms-1\files-1.1\core-0.9.6.0.aar\0db248fe8779d2711cac6d6677bfeb28\res\anim\popup_exit.xml: error: file not found.
09-May-2018 21:00:33 C:\Windows\System32\config\systemprofile.gradle\caches\transforms-1\files-1.1\core-0.9.6.0.aar\0db248fe8779d2711cac6d6677bfeb28\res\drawable-anydpi-v21\md_nav_back.xml: error: file not found.
09-May-2018 21:00:33 C:\Windows\System32\config\systemprofile.gradle\caches\transforms-1\files-1.1\play-services-base-15.0.1.aar\8bd8dfdd2cf63cd839f54537b3cca1ce\res\drawable-hdpi-v4\common_google_signin_btn_icon_dark_normal_background.9.png: error: file not found.
09-May-2018 21:00:33 C:\Windows\System32\config\systemprofile.gradle\caches\transforms-1\files-1.1\play-services-base-15.0.1.aar\8bd8dfdd2cf63cd839f54537b3cca1ce\res\drawable-mdpi-v4\common_google_signin_btn_text_dark_normal_background.9.png: error: file not found.
09-May-2018 21:00:33 C:\Windows\System32\config\systemprofile.gradle\caches\transforms-1\files-1.1\appcompat-v7-27.1.1.aar\ab46dfcb77975b5f25129199a474e726\res\drawable-hdpi-v4\abc_ic_menu_share_mtrl_alpha.png: error: file not found.
 . . . . . . . .
C:\Windows\System32\config\systemprofile.gradle\caches\transforms-1\files-1.1\core-0.9.6.0.aar\0db248fe8779d2711cac6d6677bfeb28\res\layout-ldrtl-v17\md_listitem_singlechoice.xml: error: file not found.
09-May-2018 21:00:42 Error: java.util.concurrent.ExecutionException: com.android.builder.internal.aapt.v2.Aapt2Exception: AAPT2 error: check logs for details
09-May-2018 21:00:44 :app:mergeIt2Resources FAILED
09-May-2018 21:00:44
09-May-2018 21:00:44 FAILURE: Build failed with an exception.
09-May-2018 21:00:44
09-May-2018 21:00:44 * 问题原因：
09-May-2018 21:00:44 任务':app:mergeIt2Resources'执行失败。
09-May-2018 21:00:44 > Error: java.util.concurrent.ExecutionException: com.android.builder.internal.aapt.v2.Aapt2Exception: AAPT2 error: check logs for details
09-May-2018 21:00:44
09-May-2018 21:00:44 * 建议尝试：
09-May-2018 21:00:44 使用--stacktrace选项获取堆栈跟踪。使用--info或--debug选项获取更多日志输出。使用--scan选项获取完整分析信息。
09-May-2018 21:00:44
09-May-2018 21:00:44 * 获取更多帮助请访问：https://help.gradle.org

针对这个问题，我整理了几个你可能没试过的解决方案，你可以逐一尝试：

• 清理Gradle缓存：从报错路径能看到所有缺失的文件都在Gradle系统缓存目录里，大概率是缓存文件损坏或者解压不完整。你可以在Bamboo的构建脚本里添加清理缓存的命令：
  Windows环境下执行：rd /s /q C:\Windows\System32\config\systemprofile\.gradle\caches
  之后再重新执行构建命令，让Gradle重新下载并解压所有依赖资源。

• 检查Bamboo代理的权限：缓存目录位于C:\Windows\System32\config\systemprofile下，这是系统级目录，Bamboo运行的服务用户可能没有足够的读写权限，导致依赖资源无法被正确写入缓存。你可以修改Gradle的用户目录到Bamboo有权限的路径，比如在项目的gradle.properties文件中添加：GRADLE_USER_HOME=C:\Bamboo\.gradle，这样缓存会存储到指定的有权限的目录下。

• 临时禁用AAPT2：AAPT2虽然是Android构建的默认工具，但有时候会出现兼容性问题导致这类资源合并错误。你可以在gradle.properties中添加android.enableAapt2=false来禁用它，然后重新构建项目，看是否能解决问题。

• 统一依赖版本：报错中出现的play-services-base:15.0.1和appcompat-v7:27.1.1版本可能存在兼容性问题，尝试将相关依赖版本统一到兼容的组合，比如把play-services系列依赖调整到和appcompat-v7 27.1.1匹配的版本，或者降级到更稳定的版本组合。

• 强制刷新依赖：在构建脚本中先执行./gradlew clean build --refresh-dependencies，这个命令会清理项目构建产物，同时强制Gradle重新下载所有依赖，避免本地缓存的问题。

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