React Native Android Release环境报错：java.lang.RuntimeException问题咨询

Hey，这个报错我在做React Native Android发布的时候踩过好几次坑，大概率是bundle文件没正确生成或者没被打包进APK里，下面是我亲测有效的排查解决步骤，按顺序来应该能搞定：

首先最直接的是手动生成bundle，避免自动打包时出现的问题：

• 先确认android/app/src/main/assets目录存在，如果没有，执行命令创建：

  mkdir -p android/app/src/main/assets
  

• 执行bundle打包命令（如果你的入口文件是index.js，如果是index.android.js就替换成对应文件名）：

  react-native bundle --platform android --dev false --entry-file index.js --bundle-output android/app/src/main/assets/index.android.bundle --assets-dest android/app/src/main/res/
  

  参数说明：--dev false指定生产环境打包，--bundle-output是bundle文件的输出路径，--assets-dest是图片等静态资源的输出目录。
• 打包完成后，去android/app/src/main/assets目录确认index.android.bundle文件存在，同时res目录下会新增drawable-xxx开头的文件夹（如果项目里有图片资源的话）。

打开android/app/build.gradle文件，重点检查这几部分：

• 确保项目根级的react配置包含bundleInRelease: true，这样打包release时会自动包含bundle：

  project.ext.react = [
      bundleInRelease: true,
      entryFile: "index.js" // 这里要和你的入口文件名一致
  ]
  

• 查看buildTypes里的release块，如果开启了混淆（minifyEnabled true），要确保React Native的代码没被误混淆，新手建议先临时把minifyEnabled设为false试试，排除混淆导致的问题：

  buildTypes {
      release {
          minifyEnabled false
          proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
          // 其他签名、压缩配置...
      }
  }
  

打包完release APK后，别着急安装，先确认bundle已经被包含进去：

• 执行release打包命令：

  # Mac/Linux
  cd android && ./gradlew assembleRelease && cd ..
  # Windows
  cd android && gradlew.bat assembleRelease && cd ..
  

• 用Android Studio的Build > Analyze APK功能打开生成的APK（路径一般是android/app/build/outputs/apk/release/app-release.apk），检查里面是否有assets/index.android.bundle文件。如果没有，回到步骤1和2重新检查配置。

• 如果你的RN版本低于0.60，需要在MainApplication.java里确认入口模块名称是否正确：

  @Override
  protected String getJSMainModuleName() {
      return "index"; // 对应入口文件的前缀，比如index.js就写"index"
  }
  

• RN 0.60+版本默认会自动处理路径，但还是要确保entryFile配置和实际入口文件名一致。

有时候缓存会导致奇怪的问题，先彻底清理再试：

# 清理React Native缓存
react-native start --reset-cache

# 清理Android项目缓存
cd android && ./gradlew clean && cd ..

然后重新执行bundle打包和assembleRelease命令。

如果你修改过入口文件名（比如不是默认的index.js），要确保所有地方的配置都同步更新：

• bundle命令里的--entry-file参数
• gradle配置里的entryFile值
• MainApplication里的getJSMainModuleName返回值

内容的提问来源于stack exchange，提问作者XB.Boy