Flutter应用：后台Firebase通知数据如何同步至启动后的主应用？

核心方案：使用FirebaseMessaging的getInitialMessage方法 #

冷启动（应用完全关闭后点击通知打开）时，FirebaseMessaging.onMessageOpenedApp不会触发，这时候应该用getInitialMessage直接获取启动应用的通知数据，无需依赖shared_preferences的异步存储，能实现无延迟的数据同步。

代码实现示例 #

在main函数初始化阶段调用该方法，拿到数据后直接传递给主页面：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();

  // 获取冷启动时触发应用的通知数据
  RemoteMessage? initialMessage = await FirebaseMessaging.instance.getInitialMessage();
  
  runApp(MyApp(initialNotificationData: initialMessage?.data));
}

class MyApp extends StatelessWidget {
  final Map<String, dynamic>? initialNotificationData;

  const MyApp({super.key, this.initialNotificationData});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: HomePage(initialData: initialNotificationData),
    );
  }
}

class HomePage extends StatefulWidget {
  final Map<String, dynamic>? initialData;

  const HomePage({super.key, this.initialData});

  @override
  State<HomePage> createState() => _HomePageState();
}

class _HomePageState extends State<HomePage> {
  @override
  void initState() {
    super.initState();
    // 处理冷启动带来的通知数据
    if (widget.initialData != null) {
      _handler(widget.initialData!);
    }
    // 监听后台切前台的通知触发事件
    FirebaseMessaging.onMessageOpenedApp.listen((RemoteMessage message) {
      _handler(message.data);
    });
  }

  void _handler(Map<String, dynamic> data) {
    // 你的通知数据处理逻辑
    print('处理通知数据: $data');
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('主页')),
      body: const Center(child: Text('首页内容')),
    );
  }
}

补充优化：全局状态管理同步 #

如果你的应用依赖全局状态（比如Provider、Riverpod、GetX），可以在获取到initialMessage后直接更新全局状态，主页面监听状态变化即可实时响应：

// 以Riverpod为例
final notificationDataProvider = StateProvider<Map<String, dynamic>?>((ref) => null);

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();

  RemoteMessage? initialMessage = await FirebaseMessaging.instance.getInitialMessage();
  
  runApp(
    ProviderScope(
      overrides: [
        if (initialMessage != null)
          notificationDataProvider.overrideWithValue(initialMessage.data),
      ],
      child: const MyApp(),
    ),
  );
}

// 在HomePage中监听状态变化
class HomePage extends ConsumerWidget {
  const HomePage({super.key});

  @override
  Widget build(BuildContext context, WidgetRef ref) {
    // 监听通知数据变化，自动触发处理逻辑
    ref.listen(notificationDataProvider, (previous, next) {
      if (next != null) {
        _handler(next);
      }
    });

    return Scaffold(/* ... */);
  }

  void _handler(Map<String, dynamic> data) {
    // 自定义处理逻辑
  }
}

注意事项 #

• getInitialMessage仅在冷启动时返回数据，应用处于后台时点击通知仍需用onMessageOpenedApp处理。
• 必须先完成Firebase初始化（Firebase.initializeApp()），否则无法获取消息数据。
• 避免在initState中异步调用shared_preferences取数据，异步操作会导致页面渲染后才收到数据，必然产生延迟，直接通过初始化参数或全局状态传递是同步操作，无延迟问题。

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