解决Flutter Android端:app:processDebugResources任务执行失败问题

架构老林

2026-7-19

解决Android资源链接错误：找不到mipmap/ic_launcher

以下是针对这个错误的具体排查和解决步骤：

检查mipmap目录的文件完整性
确认android/app/src/main/res/下的所有mipmap密度文件夹（如mipmap-hdpi、mipmap-mdpi、mipmap-xhdpi等）里，都存在名为ic_launcher.png（或对应格式）的图标文件。注意Android资源文件名大小写敏感，必须和Manifest里的引用完全一致，不能出现大小写错误（比如IC_Launcher或ic_launcher_1这类不符合要求的名称）。
核对AndroidManifest.xml的资源引用
打开android/app/src/main/AndroidManifest.xml，找到<application>标签的android:icon属性，确认其值为@mipmap/ic_launcher，没有拼写错误。同时检查是否存在android:roundIcon属性，也要确保它的引用同样正确。
清理缓存并重建项目
执行以下命令清理Flutter和Gradle缓存：
```
flutter clean
```
之后重新运行项目：
```
flutter run
```
如果还是不行，可以手动删除android/app/build目录，再重新编译。
验证App Icon Generator的输出
确认生成的图标包包含所有必需的mipmap密度文件夹，且每个文件夹内的图标文件名都是ic_launcher。如果生成的图标文件名是其他名称（比如ic_app_icon），要么修改Manifest里的引用匹配新名称，要么重命名所有图标文件为ic_launcher。
检查资源文件的合法性
查看IDE中res/mipmap目录下的文件是否有黄色警告标识，这通常意味着资源命名不符合Android规范（比如包含空格、特殊字符）。另外确保图标使用PNG格式，避免使用WebP等需要额外配置支持的格式（除非你已经在Gradle中开启了WebP支持）。