React Native CLI 项目在模拟器启动失败的排查与解决

问题现象

在使用最新版React Native CLI创建新项目时，开发者遇到了一个常见但容易被忽视的问题：项目在Android模拟器中启动失败，控制台显示"Starting: Intent"错误提示。这个问题在RN 0.72.x和0.73.x版本中均有出现，且发生在完全未修改的初始项目中。

环境背景

典型的环境配置包括：

• macOS 14.3系统
• M3 Pro芯片
• Android Studio 2023.2
• Java 17
• Android SDK API 33/34
• React Native 0.73.6

问题分析

表面上看，这个错误提示似乎与Android应用的启动意图(Intent)有关，容易让人联想到应用ID配置问题。但经过深入排查发现，这实际上是一个与环境配置相关的伪错误。

关键发现点在于：

1. 错误发生在完全未修改的初始项目
2. 多个RN版本均有此现象
3. 完整的开发环境已配置完成
4. 错误信息并不指向具体的代码问题

根本原因

经过仔细检查，发现问题根源在于Android模拟器的"飞行模式"默认处于开启状态。这个设置会导致：

• 模拟器无法建立正常的网络连接
• 应用启动流程被中断
• 显示误导性的Intent启动错误

解决方案

解决此问题的方法非常简单：

1. 打开Android模拟器
2. 下拉通知栏
3. 关闭"飞行模式"
4. 重新运行npx react-native run-android

经验总结

这个案例给我们几点重要启示：

1. 基础检查很重要：在排查复杂技术问题前，应先确认基础环境设置是否正确
2. 错误信息可能误导：Android开发中的错误提示不一定准确反映真实问题
3. 模拟器设置影响：模拟器的各种状态设置可能影响应用运行，需要保持默认正常状态
4. 网络连接关键性：即使是不需要网络的功能，Android应用的正常启动也依赖网络连接

对于React Native开发者，建议在遇到类似启动问题时，首先检查模拟器的基本状态，包括网络连接、存储权限等基础设置，这往往能快速解决看似复杂的问题。