AAPT报错：drawable/slider_custom_thumb资源未找到但文件存在

问题描述 #

此前应用运行正常，未修改或添加任何新XML文件，重新运行时出现报错：

AAPT: error: resource drawable/slider_custom_thumb (aka com.package.name:drawable/slider_custom_thumb) not found

该文件实际存在于drawable目录中，XML代码如下：

<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android"
android:shape="oval">
<solid android:color="@color/colorPrimary" />
<size
    android:width="25dp"
    android:height="25dp" />
 </shape>

解决步骤 #

• 清理并重建项目
  执行Android Studio菜单中的Build > Clean Project，完成后再执行Build > Rebuild Project，多数资源缓存问题可通过此方法解决。
• 检查资源引用大小写
  确认代码中引用该drawable的名称与文件名完全一致，Android资源名称区分大小写，比如不要将slider_custom_thumb误写为Slider_Custom_Thumb。
• 检查drawable目录位置
  确保文件放在通用的drawable目录下，而非drawable-v21、drawable-xxhdpi这类特定版本或密度的子目录，除非你的引用逻辑是针对对应场景的。
• 验证XML依赖资源
  检查XML中引用的@color/colorPrimary是否存在于colors.xml中，且拼写无误，依赖资源缺失也会导致当前drawable编译失败。
• 清除IDE缓存
  打开Android Studio的File > Invalidate Caches...，选择Invalidate and Restart，彻底清除IDE缓存后重新编译。
• 检查Gradle配置
  若近期更新过Gradle插件或依赖库，尝试回退到之前能正常运行的版本，排查是否为版本冲突导致的资源编译异常。

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