React-Navigation v4升级RN0.68后Android启动崩溃，iOS正常

一、先定位崩溃的具体原因 #

你现在只看到“停止运行”的提示，必须先获取崩溃日志才能精准排查：

• 用Android Studio打开项目，切换到Logcat面板，筛选Error或Exception级别日志，启动应用时捕获完整崩溃栈；
• 或者在终端执行adb logcat *:E，启动应用后复制输出的错误信息，这是解决问题的核心依据。常见触发原因包括Gesture Handler版本不兼容、类找不到、依赖冲突。

二、适配RN 0.68的Gesture Handler版本 #

React Navigation 4.x与RN 0.68兼容的react-native-gesture-handler稳定版本为1.10.3，更高版本可能存在适配问题：

1. 查看当前版本：

   npm list react-native-gesture-handler
   

2. 若版本不符，卸载重装：

   npm uninstall react-native-gesture-handler
   npm install react-native-gesture-handler@1.10.3
   

3. 清除Android构建缓存后重新编译：

   cd android && ./gradlew clean && cd .. && npx react-native run-android
   

三、修正MainActivity.java的兼容写法 #

RN 0.68的ReactActivityDelegate实现有细微调整，替换为以下代码避免冲突：

import com.facebook.react.ReactActivity;
import com.facebook.react.ReactActivityDelegate;
import com.facebook.react.ReactRootView;
import com.swmansion.gesturehandler.react.RNGestureHandlerEnabledRootView;

public class MainActivity extends ReactActivity {
  @Override
  protected String getMainComponentName() {
    return "你的项目名称"; // 替换为package.json中name字段的值
  }

  @Override
  protected ReactActivityDelegate createReactActivityDelegate() {
    return new ReactActivityDelegate(this, getMainComponentName()) {
      @Override
      protected ReactRootView createRootView() {
        return new RNGestureHandlerEnabledRootView(MainActivity.this);
      }
    };
  }
}

注意：如果原代码有自定义的MainActivityDelegate类，不要完全覆盖，仅修改createRootView的实现逻辑即可。

四、解决导航切换的Render Error（保留原代码时的问题） #

若不改MainActivity代码出现渲染错误，本质是Gesture Handler未正确初始化，必须在项目入口文件（如index.js或App.js）的最顶部添加：

import 'react-native-gesture-handler';

这行代码必须放在所有其他导入之前，包括react和react-native的导入。

五、排查依赖冲突 #

RN 0.68升级后可能出现依赖版本冲突，执行以下步骤排查：

1. 查看Android依赖树：

   cd android && ./gradlew app:dependencies
   

2. 若发现其他库依赖了不同版本的react-native-gesture-handler，在android/app/build.gradle中添加排除规则：

   dependencies {
     // 其他依赖项
     implementation(project(':react-native-gesture-handler')) {
       exclude group: 'com.facebook.react', module: 'react-native'
     }
   }
   

六、其他排查点 #

• 检查AndroidManifest.xml中是否包含android.permission.INTERNET权限（RN默认会添加，但升级后可能被覆盖）；
• 确保Android构建配置符合RN 0.68要求：android/build.gradle中kotlinVersion需设置为1.6.10及以上。

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