Android Studio构建签名APK时资源链接失败：图标资源缺失

基础排查与修复 #

• 核对AndroidManifest.xml里的图标引用：确保android:icon="@mipmap/ic_launcher"和android:roundIcon="@mipmap/ic_launcher_round"拼写完全正确，资源名区分大小写，别写错字母。
• 清理重建项目：点顶部菜单栏Build > Clean Project，完成后再点Build > Rebuild Project，清掉旧编译缓存，很多资源链接问题都能这么解决。
• 检查mipmap文件完整性：确认所有分辨率目录（mipmap-hdpi、mipmap-mdpi等）里都有ic_launcher.png和ic_launcher_round.png，文件没损坏。要是缺文件，重新用Image Asset生成时选覆盖现有文件。

进阶修复方案 #

• 检查模块级build.gradle的资源配置：看看sourceSets里有没有错误排除mipmap资源的代码，比如exclude 'mipmap/**'，有的话删掉。
• 调整构建工具版本：把buildToolsVersion换成对应SDK的最新稳定版，或者回退到之前能正常构建的版本，部分版本的构建工具可能存在资源链接bug。
• 确认资源存放路径：如果自动引用有问题，先确认图标实际在哪个目录，要是在drawable里，就把Manifest里的引用改成@drawable/ic_launcher，不过更建议保持mipmap的规范用法，先把资源位置理清楚。
• 核对构建变体的签名配置：检查debug和release版本的图标资源配置是否一致，别搞成release版本用了不存在的资源。

全局环境问题排查（多项目都出问题时用） #

• 清Android Studio缓存：关掉AS，删掉~/.android/cache（Windows路径是C:\Users\<你的用户名>\.android\cache）和项目根目录的.gradle文件夹，重启AS后再构建。
• 验证SDK完整性：打开SDK Manager，检查Android SDK Build-Tools有没有损坏或缺失，有问题就重新下载对应版本。
• 重置Image Asset工具配置：删掉~/.AndroidStudio<你的版本号>/config/plugins/imageAssetGenerator下的配置文件，重启AS后重新生成图标。

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