首次加载react native navigation包编译时触发安卓运行报错（712/303）

问题特征 #

• 执行react-native run-android启动应用时触发编译失败
• 外层统一报错提示：启动应用时发生错误，未知错误：未匹配全部成功模式
• 关联错误码：712、303

日志排查路径 #

上述提示为通用外层报错，无具体根因指向，必须通过全量编译日志定位具体问题，操作路径：

1. 编辑器顶部菜单依次点击「视图->切换输出->React Native」，查看React Native基础运行日志
2. 编辑器顶部菜单依次点击「视图->切换输出->React Native: Run android」，查看Android端编译全流程日志

高频触发场景与对应修复方案 #

场景1：原生端依赖配置缺失 #

react-native-navigation侵入性较强，需要修改Android原生入口代码，首次接入漏配是最高发原因：

• 对照官方文档逐项核对以下配置：
  • android/app/src/main/java/[项目包名]/MainActivity.java：必须继承navigation提供的NavigationActivity，替换RN默认的ReactActivity，同时按文档要求重写相关生命周期方法
  • android/app/src/main/java/[项目包名]/MainApplication.java：替换默认的ReactNativeHost实现，接入navigation的宿主配置
  • android/app/build.gradle、android/settings.gradle：确认依赖引入路径正确，RN 0.60以下版本需手动执行link操作完成关联
• 配置完成后执行缓存清理，重新编译：

cd android
./gradlew clean
cd ..
npx react-native start --reset-cache

清理完成后新开终端执行react-native run-android重新编译即可。

场景2：Android构建版本不满足依赖要求 #

react-native-navigation对Android构建版本要求高于RN初始化默认配置，版本不匹配会直接编译失败：

• 打开android/build.gradle核对版本参数：
  • minSdkVersion最低要求为21，默认初始化的16/18版本会直接报错
  • compileSdkVersion、buildToolsVersion必须和当前项目安装的react-native-navigation版本要求完全对齐
• 打开Android Studio内置SDK Manager，安装对应版本的SDK平台、构建工具组件。

场景3：Gradle版本不兼容 #

• 核对两个位置的版本配置：android/gradle/wrapper/gradle-wrapper.properties中指定的Gradle发行版版本、android/build.gradle中声明的Gradle插件版本，二者需满足版本匹配规则，同时符合当前react-native-navigation版本的兼容区间，版本不匹配时统一调整到官方文档推荐的版本即可。

内容的提问来源于stack exchange，提问作者Furkan Çakmak