RN升级至0.63.5后开发模式启动即崩溃：缺失libturbomodulejsijni.so

问题背景 #

从 RN 0.63.3 升级到 0.63.5 后，构建成功但开发模式下启动直接崩溃，错误日志核心为：

java.lang.UnsatisfiedLinkError: couldn't find DSO to load: libturbomodulejsijni.so
SoSource 0: com.facebook.soloader.ApkSoSource[root = /data/user/0/com.zcarpet/lib-main flags = 1]
SoSource 1: com.facebook.soloader.DirectorySoSource[root = ...

已尝试升级 Gradle 到 3.5.3、强制 RN 版本依赖、关闭 Hermes 等方案，但均无效。

针对性解决方案 #

1. 彻底清理缓存并重建项目 #

缓存残留是这类问题的常见诱因，执行以下命令全链路清理：

# 清理Android构建缓存
cd android && ./gradlew clean
# 清理Node依赖缓存
cd .. && rm -rf node_modules && rm package-lock.json yarn.lock
# 重新安装依赖
npm install
# 带清理参数重新运行Android项目
npx react-native run-android --clean

2. 修复Soloader依赖与初始化 #

libturbomodulejsijni.so 的加载依赖Soloader，确保配置正确：

• 在 android/app/build.gradle 的 dependencies 块中添加/确认Soloader版本：

  dependencies {
      implementation "com.facebook.soloader:soloader:0.9.0+"
  }
  

• 在 MainApplication.java 的 onCreate 方法中确保Soloader初始化代码存在：

  @Override
  public void onCreate() {
      super.onCreate();
      SoLoader.init(this, false);
      // 保留其他原有初始化代码
  }
  

3. 配置ABI过滤 #

限制NDK打包的架构，避免不兼容的SO文件问题：
在 android/app/build.gradle 的 defaultConfig 下添加：

android {
    defaultConfig {
        // 其他配置...
        ndk {
            abiFilters "armeabi-v7a", "x86", "arm64-v8a", "x86_64"
        }
    }
}

4. 确保JSC依赖正确安装 #

关闭Hermes后需依赖JSC，重新安装指定版本避免兼容性问题：

npm install jsc-android@241213.0.0 --save

安装完成后同步Gradle并重新构建。

5. 清理重复的Gradle仓库配置 #

你的allprojects.repositories中存在重复的google()和jitpack.io仓库，清理后保持唯一：

allprojects {
    configurations.all {
        resolutionStrategy {
            force "com.facebook.react:react-native:0.63.5" 
        }
    }
    repositories {
        google()
        mavenCentral()
        jcenter()
        mavenLocal()
        maven { url "$rootDir/../node_modules/react-native/android" }
        maven { url "$rootDir/../node_modules/jsc-android/dist" }
        maven { url 'https://s3.amazonaws.com/repo.commonsware.com' }
        maven { url 'https://oss.sonatype.org/content/repositories/snapshots' }
        maven { url 'https://www.jitpack.io' }
    }
    // 保留原有AGP workaround代码
}

验证方案 #

按上述步骤调整后，重新执行npx react-native run-android，观察应用是否正常启动。若仍有问题，可尝试在真机上测试（部分模拟器可能存在SO加载兼容性问题）。

内容的提问来源于stack exchange，提问作者Navid Asadi