Flutter应用后台状态下，何时调用聊天消息“已送达”更新函数？

问题根源 #

FirebaseMessaging.onMessage.listen 仅在应用前台运行时触发回调，当应用处于后台状态时，这个监听器不会执行，所以你之前的代码无法在后台更新消息状态。

正确的调用时机 #

要覆盖后台场景，需要结合以下两种Firebase Messaging回调：

1. 后台消息处理函数（必选）

使用FirebaseMessaging.onBackgroundMessage注册一个顶级函数，专门处理应用后台时收到的推送消息。这个函数会在独立的隔离环境中运行，即使应用被挂起也能触发。

首先在项目中添加顶级的后台处理函数（注意：必须是顶级函数，不能放在类或方法内部）：

Future<void> firebaseMessagingBackgroundHandler(RemoteMessage message) async {
  // 初始化Firebase（如果未全局初始化）
  await Firebase.initializeApp();
  
  if (message.data.containsKey('senderId') && message.data.containsKey('receiverId') && message.data.containsKey('receiverName')) {
    await FirebaseServices.setDeliveredStatus(
      senderId: message.data['senderId'],
      receiverId: message.data['receiverId'],
      receiverName: message.data['receiverName'],
    );
  }
}

然后在main函数中注册这个handler：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  
  // 注册后台消息处理
  FirebaseMessaging.onBackgroundMessage(firebaseMessagingBackgroundHandler);
  
  runApp(const MyApp());
}

2. 前台+通知点击监听（补充）

保留原有的onMessage监听处理前台场景，同时添加onMessageOpenedApp监听，处理用户点击通知打开应用的场景（防止后台处理未触发的情况）：

@override
void initState() {
  super.initState();
  
  // 前台收到消息时处理
  FirebaseMessaging.onMessage.listen((message) {
    if (message.notification != null) {
      LocalNotificationService.createAndDisplayNotificationChannel(message);
      _updateMessageStatus(message);
    }
  });
  
  // 用户点击通知打开应用时处理
  FirebaseMessaging.onMessageOpenedApp.listen((message) {
    _updateMessageStatus(message);
  });
}

void _updateMessageStatus(RemoteMessage message) {
  if (message.data.containsKey('senderId') && message.data.containsKey('receiverId') && message.data.containsKey('receiverName')) {
    FirebaseServices.setDeliveredStatus(
      senderId: message.data['senderId'],
      receiverId: message.data['receiverId'],
      receiverName: message.data['receiverName'],
    );
  }
}

修复setDeliveredStatus的潜在问题 #

你当前的函数中使用forEach结合async会导致更新操作无法等待完成，可能出现部分消息未更新的情况，建议改为for循环：

static Future<void> setDeliveredStatus({
  required String senderId,
  required String receiverId,
  required String receiverName,
}) async {
  print('setting = ${receiverName + receiverId}');
  print('${currentUser!.displayName!} + ${senderId}');
  
  QuerySnapshot query = await _firestore
      .collection(CollectionKeys.messages)
      .doc(receiverName + receiverId)
      .collection(currentUser!.displayName! + senderId)
      .where('status', isEqualTo: describeEnum(MessageStatus.sent))
      .get();
  
  // 使用for循环确保每个更新都等待完成
  for (var doc in query.docs) {
    await doc.reference.update({
      'status': describeEnum(MessageStatus.delivered)
    });
  }
}

额外注意事项 #

• 权限配置：确保Android端已开启后台权限，iOS端已正确配置推送权限（开启“后台刷新”权限）。
• Firestore安全规则：确认接收方用户拥有更新对应消息文档的权限，避免因权限不足导致更新失败。
• 后台环境限制：firebaseMessagingBackgroundHandler中不能调用Flutter UI相关插件（如本地通知），只能执行纯Dart或Firebase相关操作。

内容的提问来源于stack exchange，提问作者Muhammad Wamiq Siddiqui