如何解决Android项目app:processDebugResources资源链接失败报错

对应报错特征如下：

Task :app:processDebugResources FAILED
AAPT: error: resource drawable/xxx (aka 包名:drawable/xxx) not found.

可能的原因及对应解决方法如下：

• 构建缓存异常
  Android Studio增量构建缓存、R类生成缓存损坏会导致已存在的资源无法被识别。
  解决方法：依次执行菜单栏 Build > Clean Project、Build > Rebuild Project；如果问题仍然存在，关闭Android Studio，删除项目根目录的.gradle文件夹、app模块下的build文件夹，重新打开项目后点击Sync Project with Gradle Files同步配置。
• 资源存放路径错误
  1. 资源存放在带版本限定符的drawable文件夹（如drawable-v24）中，但项目minSdk低于限定符的版本，低版本编译流程不会扫描该类文件夹
  2. 资源被误放置到mipmap、raw等非drawable资源目录
  3. 多模块开发场景下，资源存放在子模块的drawable目录，主模块未正确依赖子模块，或子模块资源未设置为公开
• 资源命名不符合规范
  Android资源文件命名仅允许使用小写字母、数字、下划线，禁止以数字开头、包含大写字母、空格、特殊符号、中文字符。不符合命名规则的资源不会被AAPT识别为有效编译资源，会被判定为不存在。
• 矢量图兼容配置缺失
  若报错的drawable为xml格式矢量图，且项目minSdk < 21，需要在app模块build.gradle的defaultConfig代码块中添加配置 vectorDrawables.useSupportLibrary = true，否则编译时无法识别矢量图资源。
• 资源文件本身异常
  资源文件损坏，或后缀名与实际格式不匹配（如直接将webp文件后缀改为png），AAPT解析失败后会跳过该文件，触发资源未找到报错。
• Gradle配置异常
  app模块build.gradle中sourceSets的res路径配置错误，导致AAPT扫描资源时未覆盖资源存放目录；或Android Gradle Plugin版本与Gradle版本不兼容，导致资源编译流程异常。

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