FCM无法向所有用户推送消息：仅测试设备收通知的故障排查问询

咱们来一步步排查可能导致这个问题的原因，结合你提供的AppDelegate代码片段来分析：

1. 推送证书与环境不匹配 #

测试设备通常用的是开发环境（Development）的APNs证书，而用户设备属于生产环境（Production）。如果你的Firebase控制台配置的是开发证书，但后台给生产设备发消息，或者反过来，就会导致推送失败。

• 检查Firebase控制台的「云消息推送」配置，确认上传的APNs证书是对应生产环境的（或者已经通过Apple Developer账号关联自动配置了正确的环境）。
• 确保打包用户版本时，用的是生产环境的签名证书（Ad Hoc或App Store分发）。

2. 设备Token的环境差异 #

测试设备的FCM Token是开发环境生成的，用户设备的Token是生产环境生成的，两者不通用。如果后台错误地用开发环境的推送服务器给生产Token发消息，就会收不到。

• 可以在messaging(_:didReceiveRegistrationToken:)方法里打印Token，确认用户设备的Token和测试设备的Token格式/来源是否一致。
• 用Firebase控制台发消息时，注意选择「生产设备」目标，而不是仅测试设备。

3. 推送权限未正确获取 #

测试时你可能手动开启了推送权限，但用户设备可能默认拒绝了，或者你的代码没有正确请求权限：

• 确保在didFinishLaunchingWithOptions里添加权限请求代码：

UNUserNotificationCenter.current().requestAuthorization(options: [.alert, .badge, .sound]) { granted, error in
    guard granted else { return }
    DispatchQueue.main.async {
        UIApplication.shared.registerForRemoteNotifications()
    }
}

• 别忘了设置通知中心代理：UNUserNotificationCenter.current().delegate = self，以及Messaging代理：Messaging.messaging().delegate = self。

4. Firebase配置文件错误 #

如果测试环境和生产环境用了不同的GoogleService-Info.plist，但打包用户版本时错误地用了测试版的plist，就会导致Firebase初始化异常，无法接收推送。

• 确认用户版本的App中包含的是生产环境的GoogleService-Info.plist，并且FirebaseApp.configure()在didFinishLaunchingWithOptions的最开始就调用了。

5. 后台消息发送的环境参数错误 #

如果用API发送FCM消息，需要明确指定环境参数：

• 生产环境要设置apns-environment: production，开发环境是development。
• 同时要确保apns-push-type设置正确（比如alert对应通知类消息）。

6. 用户设备的系统/网络限制 #

用户设备的一些系统设置可能拦截了推送：

• 检查设备是否开启了「低电量模式」「专注模式」，这些模式会限制推送通知。
• 确认设备网络正常，弱网、VPN环境可能导致FCM推送无法到达。
• 确保用户设备的iOS版本兼容你使用的Firebase SDK版本（比如iOS 10+是UNUserNotificationCenter的最低要求）。

7. 代码中遗漏APNs Token关联逻辑 #

FCM需要关联APNs的Device Token才能正常推送，你需要在AppDelegate中实现这个方法：

func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
    Messaging.messaging().apnsToken = deviceToken
}

同时实现messaging(_:didReceiveRegistrationToken:)来监听Token更新，及时同步到你的服务器，避免Token过期导致推送失败。

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