React Native Firebase 在 iOS TestFlight 中无法接收推送通知的解决方案

问题背景

在使用 React Native Firebase 进行 iOS 应用开发时，开发者经常会遇到一个棘手的问题：推送通知在模拟器和真机调试时工作正常，但在通过 TestFlight 分发的版本中却无法接收。这种情况通常与 iOS 的构建配置和证书设置有关。

核心问题分析

经过对多个案例的研究，我们发现这个问题通常由以下几个关键因素导致：

1. 证书配置不当：生产环境和开发环境的推送证书混淆或配置错误
2. Entitlements 文件缺失：发布版本的 entitlements 文件未正确配置推送权限
3. 构建配置问题：Xcode 中的构建配置没有区分调试和发布模式
4. Firebase 配置问题：APNs 令牌未正确设置或类型指定错误

详细解决方案

1. 正确配置 Entitlements 文件

对于生产环境构建，必须确保有一个专门的 .entitlements 文件。例如，创建一个 YourAppNameRelease.entitlements 文件，内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>aps-environment</key>
    <string>production</string>
</dict>
</plist>

这个文件明确指定了应用在生产环境下的推送通知权限。

2. Xcode 项目配置

在 Xcode 中需要进行以下配置：

1. 确保在 Build Settings 中为 Release 配置指定了正确的 entitlements 文件路径
2. 检查 Signing & Capabilities 选项卡，确认 Push Notifications 能力已添加
3. 验证 Bundle Identifier 在所有配置中保持一致

3. AppDelegate 修改

在 AppDelegate.swift 中，确保正确处理了设备令牌：

override func application(_ application: UIApplication, 
                        didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
    Messaging.messaging().apnsToken = deviceToken
    // 明确指定生产环境令牌类型
    Messaging.messaging().setAPNSToken(deviceToken, type: .prod)
}

4. 证书管理

1. 登录 Apple Developer 账户，删除所有旧的推送证书
2. 为生产环境创建新的 Apple Push Notification service SSL 证书
3. 在 Firebase 控制台中上传新的生产证书
4. 确保开发和生产证书都正确配置

常见误区

1. 认为模拟器测试足够：模拟器无法完全模拟真实设备推送行为
2. 忽略构建配置差异：调试和发布构建可能有不同的行为
3. 证书混淆：开发和生产推送证书不能混用
4. 过度依赖自动配置：有时需要手动验证每个配置步骤

验证步骤

要确认问题是否解决，可以按照以下步骤验证：

1. 通过 TestFlight 安装应用
2. 检查应用是否能成功获取 FCM 令牌
3. 使用 Firebase 控制台或后端服务发送测试通知
4. 检查设备是否能接收到通知
5. 查看 Xcode 设备日志中的相关输出

总结

iOS 推送通知在 TestFlight 版本中失效是一个常见但可解决的问题。关键在于理解 iOS 推送系统在不同环境下的行为差异，并确保所有配置都针对生产环境进行了正确设置。通过仔细检查 entitlements 文件、证书配置和 AppDelegate 实现，大多数情况下都能解决这个问题。

对于 React Native Firebase 用户来说，保持插件版本更新也很重要，因为新版本通常会修复已知的兼容性问题。如果问题仍然存在，建议检查 Firebase 控制台中的配置，并确保所有步骤都按照官方文档正确执行。