You need to enable JavaScript to run this app. Flutter iOS端无法接收Cloud Function发送的后台通知如何解决
优惠活动
大模型
产品
解决方案
定价
更多

Flutter iOS端无法接收Cloud Function发送的后台通知如何解决

问题根因

你当前的payload配置存在多处不符合APNs规范的错误,是导致iOS后台/终止状态收不到通知的核心原因:

  1. 当apns-push-type设置为background(静默推送)时,不允许携带顶层notification字段,APNs会直接判定请求非法、拒绝下发
  2. 静默推送的apns-priority只能设置为5,设置为10属于无效参数
  3. 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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.15 09:24:04