React Native集成Firebase推送通知：Android端正常运行，iOS端出现NotRegistered错误的原因排查

你在React Native中集成Firebase推送后Android一切正常，但iOS端返回NotRegistered错误，先看下你提供的报错数据：

data:NOTIFCATION { deviceToken: 'diTk7DNPS9KsRTPSFlpSoU:APA91bEaNxB9W0g6m8487W37qTgUYmqGA2GfN1tPbwI1q60WAsHFrCdhbYzEZO-q5lfY1s3epNsSKhHpxO-OLYMGED3ZeYi_f7DHUrOpxMgC0QE7KJFslZwk3-CKnqbfkClu3tzUL6_X', title: 'Extended Session', message: 'Please extend Your parking Session expire soon' }
{"multicast_id":8523782171183643556,"success":0,"failure":1,"canonical_ids":0,"results":[{"error":"NotRegistered"}]}

结合我踩过的同类坑，这个错误主要和Token有效性、APNs配置、权限或SDK集成有关，具体原因和解决方法如下：

常见原因分析 #

• 设备Token已失效：iOS的APNs Token会在很多场景下变更——比如用户卸载重装App、重置设备、切换Apple ID、App签名更新（比如换了证书），这时候旧Token就会被Firebase标记为NotRegistered。你必须确保每次App启动时都重新获取最新Token，并同步更新到你的服务器，不能只存一次。
• APNs证书/配置不匹配：Firebase是通过APNs给iOS推消息的，如果你的APNs证书过期、无效，或者Firebase控制台里的APNs配置和当前构建环境（Debug/Release）不对应，就会导致推送失败。比如你用Debug包但配置了生产环境的APNs证书，肯定会出问题。
• 用户关闭了通知权限：如果用户在iOS系统设置里关闭了App的通知权限，APNs会直接拒绝推送请求，Firebase也会返回NotRegistered。这种情况需要在App里做权限检查，引导用户去设置开启。
• Firebase SDK集成遗漏：React Native的Firebase推送在iOS端需要正确配置AppDelegate的回调方法，如果没实现didRegisterForRemoteNotificationsWithDeviceToken并把Token传给Firebase，就会导致Token没成功注册到Firebase服务器，自然推不进去。
• 环境混淆：Debug和Release环境的Token是不通用的，如果你服务器用生产环境的配置去推Debug的Token，或者反过来，也会触发这个错误。

解决步骤 #

1. 强制更新Token：在App启动逻辑里调用Firebase获取Token的方法，每次启动都获取最新值，替换服务器中存储的旧Token。
2. 校验APNs配置：登录Firebase控制台，进入项目的「Cloud Messaging」页面，检查APNs证书是否有效，是否和当前构建环境匹配（开发证书对应Debug，生产证书对应Release）。
3. 检查通知权限：在App内添加权限检测代码，当发现权限被关闭时，弹窗提示用户前往系统设置开启通知权限。
4. 核对AppDelegate配置：检查iOS项目的AppDelegate.m（或AppDelegate.swift），确保实现了远程通知的注册回调，并正确将APNs Token传给Firebase的messaging().apnsToken = deviceToken方法。
5. 分环境测试：分别在Debug和Release环境下测试推送，确保服务器使用对应的Firebase配置（开发/生产）来发送消息。

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