Flutter FCM：onBackgroundMessage触发但列表未保留消息求助

为什么静态列表无法实现需求？ #

• FCM的onBackgroundMessage回调运行在**独立的隔离线程（Isolate）**中，和应用主进程属于完全分离的内存空间。你在后台线程里往静态列表添加的数据，主进程的静态列表完全无法访问——两个列表是不同的内存实例。
• 即便忽略线程隔离问题，一旦应用在后台被系统回收，静态列表的内容会随着内存释放彻底丢失，应用回到前台时自然为空。

必须使用持久化存储吗？ #

是的，必须依赖磁盘持久化存储方案，常见选项包括：

• SharedPreferences：适合存储少量简单结构的数据
• Hive：轻量级NoSQL数据库，支持对象存储
• SQLite：适合复杂数据结构或大量消息存储

示例：用SharedPreferences实现后台消息存储与读取 #

1. 修改后台消息处理函数：

import 'package:shared_preferences/shared_preferences.dart';
import 'dart:convert';

Future<void> _firebaseMessagingBackgroundHandler(RemoteMessage message) async {
  if (kDebugMode) {
    print('Handling a background message ${message.messageId}');
    print('message: ${message.data}');
  }
  // 初始化SharedPreferences
  final prefs = await SharedPreferences.getInstance();
  // 读取已存储的消息列表，为空则初始化空列表
  List<String> existingMessages = prefs.getStringList('background_messages') ?? [];
  // 将消息数据转为JSON字符串存储
  existingMessages.add(json.encode(message.data));
  // 写入回SharedPreferences
  await prefs.setStringList('background_messages', existingMessages);
}

2. 应用回到前台时读取并处理消息：

import 'package:shared_preferences/shared_preferences.dart';
import 'dart:convert';

void _loadAndProcessBackgroundMessages() async {
  final prefs = await SharedPreferences.getInstance();
  List<String>? messageStrings = prefs.getStringList('background_messages');
  
  if (messageStrings != null) {
    // 解析每条消息并发送到全局流
    for (String msgStr in messageStrings) {
      Map<String, dynamic> messageData = json.decode(msgStr);
      GlobalStream.addBackgroundMessage(messageData);
    }
    // 处理完成后清空存储，避免重复处理
    await prefs.remove('background_messages');
  }
}

// 在应用前台恢复时触发，比如在页面initState或生命周期监听中调用
@override
void initState() {
  super.initState();
  _loadAndProcessBackgroundMessages();
  
  // 监听应用从后台回到前台的事件
  WidgetsBinding.instance.addObserver(AppLifecycleObserver(
    onResumed: _loadAndProcessBackgroundMessages,
  ));
}

// 自定义应用生命周期监听类
class AppLifecycleObserver extends WidgetsBindingObserver {
  final VoidCallback? onResumed;

  AppLifecycleObserver({this.onResumed});

  @override
  void didChangeAppLifecycleState(AppLifecycleState state) {
    if (state == AppLifecycleState.resumed) {
      onResumed?.call();
    }
  }
}

补充说明 #

• 如果需要存储完整的RemoteMessage对象，需将其所有字段序列化为JSON字符串（注意处理嵌套结构），读取时再反序列化为对象。
• 可根据消息的复杂度、数量选择合适的持久化方案：简单数据用SharedPreferences，复杂对象优先选Hive，大量数据用SQLite。

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