React Native安卓运行执行run-android报processDebugMainManifest错误如何处理
报错
Task :app:processDebugMainManifest FAILED 解决方案 该报错本质是安卓构建过程中处理AndroidManifest.xml清单文件失败,按以下顺序排查即可:
- 排查清单文件语法错误
打开项目路径下android/app/src/main/AndroidManifest.xml,检查是否存在标签不闭合、属性拼写错误、特殊字符未转义的问题,所有自定义配置要符合安卓清单文件规范。 - 解决包名/属性冲突
- 确认
android/app/build.gradle中的applicationId值,和AndroidManifest.xml根标签的package属性值完全一致 - 如果引入的第三方SDK的清单配置和项目配置冲突(比如
allowBackup、icon、supportsRtl等属性重复定义),需要在AndroidManifest.xml的根标签添加命名空间xmlns:tools="http://schemas.android.com/tools",再在<application>标签添加冲突替换规则,示例:
<application android:name=".MainApplication" android:allowBackup="false" android:icon="@mipmap/ic_launcher" android:label="@string/app_name" android:roundIcon="@mipmap/ic_launcher_round" android:supportsRtl="false" android:theme="@style/AppTheme" tools:replace="android:allowBackup,android:icon,android:supportsRtl"> - 确认
- 适配SDK版本
打开android/build.gradle,确认compileSdkVersion、buildToolsVersion、targetSdkVersion版本匹配,无版本过高/过低导致的兼容性问题,当前React Native稳定版本建议配置为compileSdkVersion = 33、buildToolsVersion = "33.0.0"、targetSdkVersion = 33。 - 清理无效构建缓存
依次执行以下命令重置构建环境:- 进入安卓目录:
cd android - 清理安卓构建缓存:PowerShell执行
.\gradlew clean - 回到项目根目录,删除
node_modules文件夹和package-lock.json/yarn.lock文件 - 重新安装依赖:
npm install或yarn install - 重新执行运行命令:
npx react-native run-android
- 进入安卓目录:
- 检查权限配置正确性
如果适配Android 12及以上系统,要注意蓝牙、通知、定位等特殊权限的声明格式是否正确,不存在权限名拼写错误、不存在已被废弃的权限声明。
内容的提问来源于stack exchange,提问作者user9541096
相关产品推荐
相关产品推荐

