Firebase Cloud Messaging在iOS14无法推送(iOS13/安卓端正常)
FCM推送仅iOS14设备接收失败排查步骤
一、服务端代码层面优先排查(从现有实现定位问题)
- 修正请求头格式错误
现有代码中Content-Type的取值开头多了一个无意义的空格,写为' application/json'。iOS14及以上版本对接的APNs服务网关,对请求头格式的校验严格度较iOS13大幅提升,这类不规范的格式会导致推送请求被网关直接拦截;安卓通道、iOS13系统自带的容错机制不会触发这类拦截,也是跨版本表现不一致的核心诱因之一。修正为'Content-Type': 'application/json'即可。 - 补全iOS专属推送配置字段
iOS14调整了推送优先级路由规则,当请求体中没有显式声明apns配置时,FCM会自动将推送降级为普通优先级的静默推送,这类推送不会触发系统通知弹窗,仅会在应用后台唤起时同步数据。需要在原有的请求JSON结构中补全apns配置:
这类显式声明在iOS13系统中属于非必选项,系统可自动识别推送类型;但iOS14开始如果缺失这两个配置,请求会直接被系统判定为非展示类推送,不会触发通知展示。// 原bodyJSON结构中新增如下字段 apns: { headers: { "apns-priority": "10", // 高优先级,对应即时弹窗类推送 "apns-push-type": "alert" // 明确标识为通知类推送,区别于静默同步类推送 } } - 补全请求回调的日志逻辑
现有代码仅对400以上状态码的请求做错误打印,忽略了FCM正常返回200状态码但实际推送失败的场景——FCM经常会在200响应的body中返回单条推送的错误原因(比如token失效、注册信息无效),这类错误不会触发HTTP状态码异常,现有代码只会打印“Done!”,根本无法定位问题。需要在200分支下也打印完整的响应body,确认是否存在单条设备的推送报错。
二、客户端侧排查点
- 校验iOS14设备的FCM token有效性
iOS14调整了设备推送token的重置触发逻辑,如果用户在系统设置中曾关闭通知权限后再重新开启,FCM token会自动失效。如果客户端没有做token失效的监听上报,服务端存储的deviceId很可能是旧系统生成的失效token,就算推送请求格式完全正确,也会因为token无效被FCM丢弃。 - 校验iOS14系统的推送权限状态
iOS14新增了通知「临时授权」分支:如果用户当初触发了临时允许,72小时后权限会自动降级为不允许,且系统不会主动弹出提示提醒用户。需要检查对应设备的通知权限、应用后台刷新权限是否处于开启状态,这类权限状态变化是iOS14上推送失效的常见诱因。
内容的提问来源于stack exchange,提问作者Naresh Pawar
相关产品推荐
相关产品推荐

