运行React Native应用报Gradle及mipmap资源缺失错误如何解决
React Native安卓构建失败排查解决步骤
核心错误修复(构建失败直接原因)
本次构建失败的根因是安卓打包时找不到应用图标资源,按以下步骤排查:
- 检查图标资源是否存在
进入项目android/app/src/main/res/目录,查看所有以mipmap-开头的文件夹(如mipmap-mdpi、mipmap-hdpi、mipmap-xhdpi等),确认是否存在名为storyqube的图标文件(支持png、webp格式)。注意安卓资源文件名只能用小写字母、数字和下划线,大写字母、特殊字符都会导致识别失败。 - 核对清单文件引用配置
打开报错指定的android/app/src/main/AndroidManifest.xml文件,定位到第13行附近的android:icon属性,确认属性值为@mipmap/storyqube,和实际的图标文件名完全一致。如果暂时没有对应图标,可先修改为默认值@mipmap/ic_launcher先跑通构建。 - 清理缓存后重新构建
如果是刚替换过图标出现的报错,依次执行以下命令清理缓存后重试:- 进入安卓项目目录:
cd android - 清理Gradle构建缓存:Windows系统执行
gradlew.bat clean,Mac/Linux系统执行./gradlew clean - 返回项目根目录清理RN缓存:
cd .. && npx react-native start --reset-cache - 重新触发构建:
npx react-native run-android
- 进入安卓项目目录:
附带警告优化(非构建失败原因,可避免后续兼容问题)
- 修复
compile配置过时警告:打开android/app/build.gradle和android/build.gradle文件,将所有依赖声明中的compile关键字替换为implementation即可。 - 修复Build Tools版本过低警告:打开
android/app/build.gradle文件,找到buildToolsVersion '23.0.1'这一行直接删除即可,新版Android Gradle插件会自动适配兼容的构建工具版本,无需手动指定。
内容的提问来源于stack exchange,提问作者Rohit517
相关产品推荐
相关产品推荐

