Flutter集成Firebase Messaging：iOS设备无法接收纯数据消息问题排查

你遇到的Android正常但iOS纯数据消息没响应的问题，我之前在开发Flutter推送功能时也踩过同样的坑。结合你的配置和代码，这里给你几个关键的修复点：

1. 修正APNS配置中的apns-topic（最关键的错误） #

你的Cloud Functions里apns-topic设置成了io.flutter.plugins.firebase.messaging，这是错误的！APNS的topic必须严格匹配你的iOS App的Bundle ID（比如com.yourcompany.yourapp），否则推送会被APNS静默拒绝，不会到达设备。修改后的配置应该是：

{ 
  android: { 
    priority: "high", 
  }, 
  apns: { 
    payload: { 
      aps: { 
        contentAvailable: true, 
      }, 
    }, 
    headers: { 
      "apns-push-type": "background", 
      "apns-priority": "5", 
      "apns-topic": "com.yourcompany.yourapp", // 替换成你的Bundle ID
    }, 
  }, 
}

2. 确保iOS开启后台推送权限 #

纯数据消息需要App拥有后台推送权限，步骤如下：

• 打开Xcode中的iOS项目，进入Signing & Capabilities标签页
• 添加Background Modes能力，勾选Remote notifications选项
• 确认Info.plist中存在UIBackgroundModes键，且包含remote-notification值（Xcode勾选后会自动添加，可手动检查）

3. 补充后台消息监听逻辑 #

iOS上，纯数据消息在App处于后台/杀死状态时，不会触发onMessage回调，而是需要通过onBackgroundMessage处理。你目前只监听了前台消息，需要添加后台处理器：

首先定义一个顶级的后台消息处理函数（必须是顶级函数，不能是类成员，因为Flutter的后台隔离环境需要访问）：

Future<void> firebaseMessagingBackgroundHandler(RemoteMessage message) async {
  await Firebase.initializeApp();
  print('Received background data message: ${message.data}');
  // 这里处理后台数据，比如展示本地通知
  FlutterLocalNotificationsPlugin().show(
    0,
    '后台数据通知',
    '收到新的纯数据消息',
    NotificationDetails(
      android: BackgroundHandler.androidNotificationDetails,
      iOS: BackgroundHandler.iosNotificationDetails
    )
  );
  NotificationManager.handleNotificationData(message.data);
}

然后在main函数中注册这个处理器：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  
  // 注册后台消息处理器
  FirebaseMessaging.onBackgroundMessage(firebaseMessagingBackgroundHandler);
  
  // 初始化Android通知通道
  await FlutterLocalNotificationsPlugin()
      .resolvePlatformSpecificImplementation<AndroidFlutterLocalNotificationsPlugin>()
      ?.createNotificationChannel(channel);
  
  runApp(MyApp());
}

4. 测试场景注意事项 #

• 必须用真实iOS设备测试：模拟器无法接收APNS推送
• 区分测试场景：
  • App前台：纯数据消息触发onMessage
  • App后台/杀死：触发onBackgroundMessage
• 可以用Firebase控制台的"Cloud Messaging"测试推送，选择"自定义数据"模式，勾选"内容可用"选项来验证

5. 检查插件版本 #

确保firebase_messaging和flutter_local_notifications是最新稳定版，旧版本可能存在iOS纯数据推送的兼容性问题。运行以下命令更新：

flutter pub upgrade firebase_messaging flutter_local_notifications

按照以上步骤调整后，iOS的纯数据消息应该就能正常触发处理逻辑了。

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