Flutter iOS端无法接收Cloud Function发送的后台通知如何解决
问题根因
你当前的payload配置存在多处不符合APNs规范的错误,是导致iOS后台/终止状态收不到通知的核心原因:
- 当
apns-push-type设置为background(静默推送)时,不允许携带顶层notification字段,APNs会直接判定请求非法、拒绝下发 - 静默推送的
apns-priority只能设置为5,设置为10属于无效参数 apns-topic填写错误,你写的是Flutter FCM插件的包名,实际应该填你自己应用的Bundle ID
修复方案
1. 修正Cloud Function payload配置
你需要用「静默推送触发后台回调 + 本地弹出通知」的方案实现需求,正确配置参考如下:
var payload = { // 移除顶层notification字段,所有参数放到data中 data: { title: "My Title", body: "My message", // 其他自定义业务字段都放在这里 }, android: { priority: "high" }, apns: { payload: { aps: { contentAvailable: true, // 如果需要修改通知内容可以加 mutableContent: true }, }, headers: { "apns-push-type": "background", "apns-priority": "5", // 静默推送固定为5 "apns-topic": "你自己应用的Bundle ID", // 替换成你的应用实际包名,比如com.xxx.chat }, }, topic: `mytopic`, // 用token推送也保持该结构即可 };
2. 客户端配置校验
- 确认Xcode中
Signing & Capabilities下已开启Push Notifications和Background Modes,且Background Modes勾选了Remote notifications - 确认
FirebaseMessaging.onBackgroundMessage是在main函数中全局注册的顶级异步函数,不能封装在页面逻辑内 - 引入
flutter_local_notifications插件,在onBackgroundMessage回调中收到推送后,调用本地通知接口弹出用户可见的提醒 - 确认应用启动时已经向用户申请了通知权限,且用户已经同意
终止状态接收说明
iOS系统默认不会将静默推送给下发被用户手动杀掉的应用,如果需要在应用终止时也能收到可见通知,可以额外新增普通通知推送通道,两种推送并行发送即可覆盖所有场景。
内容的提问来源于stack exchange,提问作者Jack's
相关产品推荐
相关产品推荐

