如何修复TestFlight中EXC_CRASH (SIGABRT)启动崩溃问题

第一步：从崩溃日志定位核心问题 #

先聚焦崩溃日志的关键信息，优先排查以下方向：

• 检查崩溃线程的调用栈顶部：如果是EXC_CRASH (SIGABRT)且关联RCTFatal，说明原生模块初始化失败，大概率是依赖未正确适配Expo
• 查看是否有权限相关报错：比如日志提到NSCameraUsageDescription缺失，Expo GO会自动补全基础权限，但生产构建需要手动在app.json中声明
• 确认是否是签名/证书问题：如果日志包含CodeSignatureInvalid，检查Provisioning Profile是否包含应用请求的所有权限，且和eas.json中的签名配置一致

第二步：package.json依赖排查 #

• 执行npx expo doctor：自动检测依赖冲突，修复和当前Expo SDK版本不兼容的包
• 替换非Expo兼容的原生模块：比如把react-native-camera换成expo-camera，react-native-geolocation-service换成expo-location，这类纯RN模块在Expo预构建中容易出现链接问题
• 清理冗余依赖：删除package.json中未使用的包，避免构建时引入无效原生代码

第三步：构建与配置修复 #

• 彻底重置预构建文件：执行npx expo prebuild --clean，删除旧的ios/android目录后重新生成，确保原生配置和Expo同步
• 检查eas.json生产配置：确保生产profile的配置如下：

  "production": {
    "ios": {
      "buildConfiguration": "Release"
    },
    "android": {
      "buildType": "AppBundle"
    },
    "env": {
      "NODE_ENV": "production"
    }
  }
  

• 手动验证iOS配置：
  1. 检查app.json中ios.infoPlist是否包含所有必要权限声明
  2. 确认ios.entitlements配置和Provisioning Profile匹配，比如后台推送、钥匙串访问等

第四步：验证分发环节 #

• 先打包Ad Hoc版本：用eas build --profile production --platform ios --local生成本地构建包，通过Xcode安装到真机测试，排除TestFlight分发的特殊问题
• 重新上传时清理缓存：执行eas build --clear-cache后再构建上传，避免旧缓存导致的构建异常

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