使用EAS构建的iOS端React Native应用启动即崩溃求助

核心排查与解决步骤 #

1. 优先获取崩溃日志定位根因 #

• 连接测试设备到Mac，打开Xcode的Window > Devices and Simulators，选中设备后点击View Device Logs，找到对应应用的崩溃记录，重点查看Thread 0的调用栈信息，直接定位崩溃代码位置。
• 无Mac的情况下，可在iOS设备的设置 > 隐私与安全性 > 分析与改进 > 分析数据中，查找以应用名称开头的崩溃日志，重点关注Exception Type和Exception Codes字段。

2. 检查签名与权限配置 #

• 确认eas.json里preview配置项的签名参数正确，使用的adhoc证书、配置文件未过期，且配置文件包含测试设备的UDID。
• 核对Info.plist中的权限声明，即使极简应用，缺失必要权限（如网络权限，若应用存在隐性网络请求）也可能触发崩溃。
• 在Apple Developer后台验证证书、配置文件的有效性，确保没有权限或过期问题。

3. 清理缓存与排查模块兼容性 #

• 执行全量缓存清理，避免旧缓存干扰：

  expo r -c
  rm -rf ~/.expo/cache
  cd ios && pod deintegrate && pod install && cd ..
  

• 检查所有Expo第三方模块是否适配Expo 45版本，bare workflow下部分模块的原生依赖可能存在版本冲突。
• 临时移除非核心依赖，仅保留基础框架重新构建测试，逐步排查是否为特定模块导致崩溃。

4. 对比构建环境差异 #

• 模拟器运行是debug模式，预览构建是release模式，检查eas.json中preview配置是否开启了代码混淆、压缩等可能引发崩溃的选项，可临时关闭后重新构建验证。
• 确认测试设备的iOS版本不低于项目配置的最低版本（查看Podfile或Info.plist中的IPHONEOS_DEPLOYMENT_TARGET字段）。

5. 验证原生层配置 #

• 检查AppDelegate.m/AppDelegate.swift中的Expo初始化代码，确保EXAppDelegateWrapper等核心配置正确无误。
• 查看pod install执行时的警告信息，针对性解决原生依赖冲突或重复引用问题。

快速验证方案 #

1. 用Xcode直接打包adhoc版本安装到测试设备，若同样崩溃，可直接在Xcode中断点调试定位问题。
2. 新建空白Expo bare workflow项目，用相同的eas build --profile preview --platform ios命令构建，测试是否能正常启动，排除全局环境或配置模板问题。

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