Flutter中应用完全关闭时如何本地存储Firebase推送通知？

我明白你遇到的困扰了——前台和后台（应用未完全关闭）状态下，Firebase推送能正常存入Hive，但应用彻底关闭后就失效。核心问题在于Firebase的onBackgroundMessage回调是在独立的隔离Isolate中运行的，这个环境和主应用Isolate完全分离，主Isolate中初始化的Hive状态不会被共享到这里，直接调用存储方法自然会失败。

下面是针对性的解决步骤和代码修改方案：

核心原因拆解 #

Firebase后台消息处理是在一个脱离主应用的独立执行环境中完成的，所有依赖（比如Hive的初始化、存储Box的打开）都必须在这个Isolate内部重新完成，不能依赖主Isolate的初始化结果。

具体解决步骤 #

1. 在后台消息回调中重新初始化Hive #

你需要在getBackGroundMessage方法最开始，手动完成Hive的初始化、适配器注册（如果用了自定义类型）和Box打开操作。

2. 修改getBackGroundMessage方法 #

更新你的后台消息处理函数，加入完整的Hive初始化逻辑：

Future<void> getBackGroundMessage(RemoteMessage message) async {
  // 1. 在后台Isolate中重新初始化Hive
  await Hive.initFlutter();
  // 2. 注册自定义模型的适配器（如果你的RemoteMessageModel用了TypeAdapter）
  // 示例：Hive.registerAdapter(RemoteMessageModelAdapter());
  // 3. 打开对应的存储Box
  final notificationBox = await Hive.openBox<RemoteMessageModel>('notifications');

  // 4. 执行你的业务逻辑
  badgeCount += 1;
  await FlutterAppBadger.updateBadgeCount(badgeCount);
  final remoteModel = RemoteMessageModel.fromJson(message.toMap());
  
  // 5. 存入Hive（这里直接用打开的Box，也可以适配你的StorageHiveHelper）
  await notificationBox.add(remoteModel);

  // 6. 操作完成后关闭Box，避免资源泄漏
  await notificationBox.close();
}

3. 适配你的StorageHiveHelper（可选） #

如果你想继续使用封装好的StorageHiveHelper，需要修改它的方法，确保在后台Isolate中能自动完成初始化：

class StorageHiveHelper {
  Future<void> save(RemoteMessageModel model) async {
    // 检查Hive是否已初始化、Box是否打开
    if (!Hive.isBoxOpen('notifications')) {
      await Hive.initFlutter();
      // 注册适配器（如果需要）
      // Hive.registerAdapter(RemoteMessageModelAdapter());
      await Hive.openBox<RemoteMessageModel>('notifications');
    }
    final box = Hive.box<RemoteMessageModel>('notifications');
    await box.add(model);
  }
}

4. iOS平台额外配置 #

在iOS上，要让后台消息处理生效，还需要：

• 打开Xcode项目，在Signing & Capabilities中开启Background Modes，并勾选Remote notifications。
• 确保FlutterFire的iOS配置已正确完成（通常初始化Firebase时会自动配置，但可以检查AppDelegate.swift中的相关代码）。

关键注意事项 #

• Isolate独立性：后台Isolate无法访问主Isolate的任何变量或对象，所有依赖必须内部初始化。
• 自定义模型适配：如果RemoteMessageModel用了Hive的TypeAdapter，必须在后台Isolate中重新注册，否则会序列化失败。
• 计数同步问题：全局变量badgeCount在后台Isolate中的修改不会同步到主Isolate，建议把badge计数也存入Hive，主Isolate启动时从Hive读取最新值。

修改后，当应用完全关闭时，Firebase后台消息回调会在独立Isolate中完成Hive初始化和存储操作，就能解决你遇到的问题了。

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