本文旨在解决React Native 0.70.6项目在发布APK时遇到的`java.lang.RuntimeException: Unable to load script`崩溃问题。该问题通常发生在开发环境正常、但最终发布的应用无法启动的情况下。核心解决方案是调整项目中的Gradle版本配置，确保Android Gradle插件与React Native版本之间的兼容性，从而正确打包JavaScript bundle。
React Native 0.70.6 发布版 APK 脚本加载失败：问题诊断与解决方案
在将React Native项目升级到0.70.6版本后，开发者可能会遇到一个棘手的问题：应用程序在开发模式下（例如通过npm run android）运行一切正常，甚至APK打包过程也顺利完成，但在安装并运行最终生成的发布版APK时，应用却意外崩溃，并抛出java.lang.RuntimeException: Unable to load script. Make sure you're either running Metro...的错误。
问题现象与错误分析
当React Native应用在发布模式下崩溃并显示上述错误时，通常意味着JavaScript bundle文件（index.android.bundle）未能正确地打包到APK中，或者在运行时无法被Android原生代码加载。完整的错误堆栈通常指向com.facebook.react.bridge.CatalystInstanceImpl.jniLoadScriptFromAssets，这明确表明是JavaScript脚本的加载环节出了问题。
尽管开发者可能已经检查了项目配置，例如android/app/build.gradle中的bundleInRelease: true设置，并确认Metro服务器没有运行（发布版APK不需要Metro），但问题依然存在。这种情况下，即使尝试创建一个全新的React Native 0.70.6项目并生成发布版APK可以正常工作，也无法解决现有项目的问题，这暗示着问题可能与项目的特定依赖或构建配置有关。
根本原因：Gradle 版本不兼容
经过排查，此类问题往往源于项目使用的Gradle版本与React Native 0.70.6以及对应的Android Gradle插件（AGP）之间存在不兼容。React Native的构建系统依赖于Android Gradle插件来处理JavaScript bundle的打包和资源集成。当Gradle版本或AGP版本过高或不匹配时，可能会导致打包逻辑出现偏差，从而使index.android.bundle文件在发布版APK中缺失或损坏。
在React Native 0.70.6的特定上下文中，将Gradle版本从7.5.1降级到7.3.3，并将Android Gradle插件版本从7.2.1降级到7.1.1，已被证明是有效的解决方案。
解决方案步骤
要解决此问题，需要修改两个关键的Gradle配置文件：
1. 修改 android/gradle/wrapper/gradle-wrapper.properties
打开项目根目录下的android/gradle/wrapper/gradle-wrapper.properties文件，找到distributionUrl这一行，并将其中的Gradle版本从7.5.1修改为7.3.3。
修改前：
# ... distributionUrl=https\://services.gradle.org/distributions/gradle-7.5.1-all.zip # ...
修改后：
# ... distributionUrl=https\://services.gradle.org/distributions/gradle-7.3.3-all.zip # ...
2. 修改 android/build.gradle
打开项目根目录下的android/build.gradle文件，找到buildscript块内的dependencies部分，将com.android.tools.build:gradle的版本从7.2.1修改为7.1.1。
修改前：
buildscript {
// ...
dependencies {
classpath("com.android.tools.build:gradle:7.2.1")
// ...
}
}修改后：
buildscript {
// ...
dependencies {
classpath("com.android.tools.build:gradle:7.1.1")
// ...
}
}执行清理与重新构建
完成上述修改后，务必执行以下步骤以确保更改生效：
-
清理项目：
cd android ./gradlew clean cd .. # 或者在项目根目录 react-native clean # 如果有这个命令，或者手动删除 node_modules/.cache 和 android/build
建议同时删除node_modules目录并重新安装依赖：
rm -rf node_modules npm install # 或 yarn install
-
重新生成发布版APK：
npx react-native build-android --mode=release # 或者通过 Android Studio 生成
注意事项与最佳实践
- 版本匹配的重要性： React Native、Android Gradle插件和Gradle本身之间存在复杂的兼容性关系。当升级React Native版本时，务必查阅官方文档或社区推荐，以确定最佳的Gradle和AGP版本组合。
- Java 版本： 虽然本问题主要与Gradle版本有关，但Java版本也可能影响Android构建。确保使用的Java版本（例如OpenJDK 11或17）与React Native和Android SDK的要求兼容。在React Native 0.70.6中，OpenJDK 11是推荐的版本。
- Hermes 与新架构： 如果项目中启用了Hermes引擎或新的架构（New Architecture），Gradle的兼容性问题可能会更加突出。确保所有相关配置（如enableHermes和isNewArchitectureEnabled）在正确的Gradle环境下得到支持。
- 逐步升级： 对于大型或复杂的项目，建议在升级React Native版本时，先在一个隔离的分支或环境中进行，并逐步测试，而不是一次性升级所有依赖。
- 清理缓存： 遇到构建问题时，彻底清理Gradle缓存（~/.gradle/caches）和项目构建目录（android/build，android/app/build）通常是一个好的开始。
通过将Gradle版本降级到与React Native 0.70.6更兼容的版本，可以有效解决发布版APK中JavaScript脚本加载失败的问题，确保应用程序的稳定运行。
