React Native安卓真机Debug模式启动崩溃，Release及模拟器正常

看你的情况，安卓真机Debug模式刚启动就卡崩，只有ReactInstanceManager.ctor()这一行日志，而且Release和模拟器都正常，还刚更新过React版本、做了不少代码变更，那大概率是Debug模式特有的配置、缓存或者第三方依赖兼容性问题，咱们一步步来排查：

1. 先搞定网络连通性（Debug模式核心依赖） #

安卓真机Debug必须和电脑上的Metro服务器连通，这是最容易被忽略的点：

• 确保你的手机和电脑在同一个Wi-Fi网络下，别一个连热点一个连家里Wi-Fi
• 关掉VPN、代理工具，这些很容易阻断Debug连接
• 手动指定Metro地址：启动项目时用react-native run-android --host 你的电脑本地IP，或者在手机的开发者菜单里找到「Debug server host & port for device」，输入你的电脑IP:8081

2. 彻底清理缓存（版本更新后必做） #

更新React Native版本后，缓存残留是Debug模式崩溃的重灾区：

• 清理RN缓存：运行npm start -- --reset-cache
• 清理安卓构建缓存：进入项目的android目录，执行./gradlew clean
• 先卸载手机上的Debug版本，再重新构建安装

3. 排查第三方原生库的兼容性 #

你用了一堆涉及原生代码的库（比如react-native-camera、react-native-firebase这些），RN版本更新后很容易出现Debug模式适配问题：

• 先逐个注释掉这些库的业务代码，比如先把扫码、图片选择的代码注释掉，看看启动是否正常，定位到具体哪个库搞事情
• 检查这些库的版本是否支持RN0.59.8：比如react-native-camera@2.0.1，可以看看它的发布说明，或者临时升级到官方标注兼容0.59.x的版本试试
• 注意react-native-camera的postinstall脚本，会不会在安卓端也有路径问题？可以暂时注释掉这个脚本，重新安装依赖后测试

4. 检查Babel和Metro转译配置 #

Debug模式下的代码转译出错也会导致启动卡死：

• 先彻底重装依赖：rm -rf node_modules package-lock.json && npm install，避免依赖版本冲突
• 检查你的Babel配置（.babelrc或babel.config.js），比如babel-plugin-transform-inline-environment-variables这个插件，试试暂时去掉它，看是否能正常启动
• 确认metro-react-native-babel-preset版本（你用的0.53.1）和RN0.59.8是匹配的，这个版本是兼容的，但重装后能确保没有损坏

5. 抓取更详细的崩溃日志 #

默认的logcat日志太浅，得抓更细的错误信息：

• 运行adb logcat *:E，查看所有系统级错误日志，大概率能找到崩溃的具体原因
• 或者过滤RN相关日志：adb logcat ReactNative:V ReactNativeJS:V *:E，这样能看到启动过程中RN层的详细输出，找到卡住的环节

6. 检查安卓Manifest权限配置 #

Debug模式下有些权限没配置对也会崩：

• 打开android/app/src/main/AndroidManifest.xml，确保有android.permission.INTERNET（Debug必须）、android.permission.DEBUG_APP这些权限
• 有些库需要动态申请权限，但Debug模式下初始化时可能没处理好，导致启动崩溃，可以暂时注释掉权限申请的代码测试

7. 排查Redux中间件的问题 #

你用了redux-logger，Debug模式下它会输出大量日志，有时候会因为处理复杂state导致启动卡住：

• 暂时注释掉redux-logger的配置，只保留其他中间件，看看是否能正常启动

如果以上方法都没找到问题，建议你创建一个全新的RN0.59.8项目，把代码一点点迁移过去，每次迁移一部分功能就测试安卓真机Debug模式，这样能精准定位到哪段代码或配置导致的崩溃。

内容的提问来源于stack exchange，提问作者Thorsten Rutte