You need to enable JavaScript to run this app. React Native应用运行崩溃 Logcat报无法加载脚本错误
优惠活动
大模型
产品
解决方案
定价
更多

React Native应用运行崩溃 Logcat报无法加载脚本错误

React Native 应用初始化崩溃(JS脚本加载失败)排查指南

报错核心说明

这是React Native安卓端最常见的启动崩溃之一,触发时机为React上下文初始化阶段,崩溃逻辑非常直接:系统尝试加载JS脚本时,两个备用加载路径全部失效——要么开发模式下连不上本地Metro服务,要么发布模式下APK包内根本找不到内置的JS Bundle文件。

开发调试场景触发原因与对应解决

  • Metro开发服务未启动:在项目根目录执行npx react-native start启动Metro,等待服务完全就绪后再重新安装应用,运行Metro的终端窗口不要提前关闭。
  • 设备无法访问Metro服务:实体机调试时执行adb reverse tcp:8081 tcp:8081把电脑端Metro端口映射到设备本地;同时确认手机和开发电脑连接同一局域网,没有被VPN、防火墙拦截8081端口的流量。
  • 应用内调试地址配置错误:应用启动后摇一摇调出开发者菜单,进入Dev Settings页面,核对调试服务器地址为开发电脑的局域网IP、端口和Metro实际监听端口一致,不要留存之前的错误历史地址。
  • Metro端口被占用:启动Metro时提示8081端口被其他进程占用,可执行npx react-native start --port <可用端口号>切换监听端口,同步更新应用Dev Settings里的端口配置后重试。

发布打包场景触发原因与对应解决

  • 打包流程遗漏内置Bundle生成步骤:Release模式下应用不会从Metro拉取JS代码,必须先手动生成内置Bundle。安卓端可执行以下命令完成生成:
    npx 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
    执行完成后检查安卓模块的assets目录下确实生成了bundle文件,再走正式打包流程。
  • 打包配置路径不匹配:检查app模块build.gradle的Release构建配置,确认JS Bundle的加载路径和实际生成的文件路径完全一致,避免大小写错误、目录层级写错导致的文件找不到问题。
  • 二次打包流程丢失Bundle文件:如果打包流程接入了多渠道分包、应用加固工具,打包完成后要解压最终产出的APK,检查assets目录下的RN Bundle文件是否被工具误清理,确认文件存在后再分发。

内容的提问来源于stack exchange,提问作者Nithya

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.18 07:24:11