React Native Firebase 中 iOS 平台 Crashlytics 初始化问题解析

问题现象

在 React Native Firebase 项目中，开发者遇到 iOS 平台 Crashlytics 服务无法正常启动的问题。具体表现为：

1. 调用 crashlytics().crash() 方法时，应用并未真正崩溃
2. Xcode 日志显示 Crashlytics 收集功能未启用
3. 尽管 firebase.json 配置正确，但应用似乎没有读取这些配置
4. 相同配置在 Android 平台工作正常

根本原因分析

经过深入排查，发现问题的核心在于 iOS 构建过程中，React Native Firebase 的配置脚本未能正确执行。具体表现为：

1. 构建日志中缺少关键的 "RNFB build script started" 信息
2. Info.plist 文件中缺少预期的 firebase_json_raw 键值
3. 虽然 pod install 过程显示成功，但配置脚本未被正确注入到 Xcode 项目中

解决方案

1. 确保配置脚本正确执行

首先需要验证 React Native Firebase 的配置脚本是否被正确添加到 Xcode 项目中：

1. 打开 Xcode 项目
2. 导航到 Build Phases 选项卡
3. 检查是否存在 "Bundle React Native code and images" 阶段
4. 确认该阶段包含了执行 ios-config.sh 脚本的命令

2. 彻底清理并重建项目

当遇到配置不生效的情况，建议执行以下完整清理步骤：

1. 删除 node_modules 目录
2. 删除 ios/Pods 目录
3. 删除 ios/build 目录
4. 删除 ios/Podfile.lock 文件
5. 运行 pod deintegrate 命令
6. 运行 pod setup 命令
7. 运行 pod install 命令

3. 验证配置传递

可以通过以下方法验证配置是否正确传递到应用中：

1. 构建应用后，找到生成的 .app 文件
2. 右键显示包内容，打开 Info.plist 文件
3. 查找 firebase_json_raw 键值
4. 使用 base64 解码该值，确认包含正确的 Crashlytics 配置

最佳实践建议

1. 配置验证：在开发阶段，始终检查 Xcode 构建日志，确认能看到 "RNFB build script started" 信息
2. 环境一致性：确保开发环境中的 Ruby 和 CocoaPods 版本与团队其他成员一致
3. 多目标处理：如果项目使用多个构建目标，确保每个目标都正确配置了 Firebase 相关脚本
4. 调试技巧：可以在 ios-config.sh 脚本中添加额外的日志输出，帮助定位问题

总结

React Native Firebase 在 iOS 平台的 Crashlytics 初始化问题通常源于构建过程中的配置脚本执行问题。通过系统性地验证脚本执行、彻底清理项目环境以及仔细检查配置传递，可以有效解决这类问题。对于使用较新 Mac 设备（如 M1/M2 系列）的开发者，还需要特别注意 Ruby 环境和 CocoaPods 的兼容性问题。