如何在Flutter中运行后台服务监听Firebase实时数据库并触发本地通知

1. 添加必要依赖 #

在pubspec.yaml中引入所需包：

dependencies:
  flutter:
    sdk: flutter
  firebase_core: ^2.15.0
  firebase_database: ^10.2.0
  flutter_local_notifications: ^16.1.0
  workmanager: ^0.5.1

执行flutter pub get安装依赖。

2. 初始化Firebase #

在应用启动时完成Firebase初始化：

import 'package:flutter/material.dart';
import 'package:firebase_core/firebase_core.dart';
import 'package:workmanager/workmanager.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  // 初始化后台任务调度器
  Workmanager().initialize(
    callbackDispatcher,
    isInDebugMode: true, // 发布版本改为false
  );
  runApp(const MyApp());
}

3. 配置本地通知 #

初始化本地通知插件，创建安卓通知通道（Android 8.0+强制要求）：

import 'package:flutter_local_notifications/flutter_local_notifications.dart';

final FlutterLocalNotificationsPlugin _notificationsPlugin = FlutterLocalNotificationsPlugin();

Future<void> initNotifications() async {
  // 安卓初始化配置
  const AndroidInitializationSettings androidInit = AndroidInitializationSettings('@mipmap/ic_launcher');
  // iOS初始化配置
  const DarwinInitializationSettings iosInit = DarwinInitializationSettings(
    requestAlertPermission: true,
    requestBadgePermission: true,
    requestSoundPermission: true,
  );
  const InitializationSettings initSettings = InitializationSettings(
    android: androidInit,
    iOS: iosInit,
  );

  await _notificationsPlugin.initialize(initSettings);

  // 创建安卓通知通道
  const AndroidNotificationChannel channel = AndroidNotificationChannel(
    'db_updates_channel',
    '数据库更新通知',
    description: 'Firebase数据库变更时推送通知',
    importance: Importance.high,
  );
  await _notificationsPlugin.resolvePlatformSpecificImplementation<AndroidFlutterLocalNotificationsPlugin>()?.createNotificationChannel(channel);
}

// 触发本地通知的方法
Future<void> _showNotification(String title, String body) async {
  const AndroidNotificationDetails androidDetails = AndroidNotificationDetails(
    'db_updates_channel',
    '数据库更新通知',
    channelDescription: '数据库变更通知',
    importance: Importance.high,
    priority: Priority.high,
  );
  const DarwinNotificationDetails iosDetails = DarwinNotificationDetails();
  const NotificationDetails notificationDetails = NotificationDetails(
    android: androidDetails,
    iOS: iosDetails,
  );

  await _notificationsPlugin.show(
    0,
    title,
    body,
    notificationDetails,
  );
}

4. 实现后台监听任务 #

通过WorkManager创建后台任务，在任务中监听Firebase实时数据库的变化：

void callbackDispatcher() {
  Workmanager().executeTask((task, inputData) async {
    // 后台环境需重新初始化Firebase
    await Firebase.initializeApp();
    await initNotifications();

    // 监听目标数据库节点（替换成你的节点路径）
    DatabaseReference dbRef = FirebaseDatabase.instance.ref('your_target_node');
    
    // 订阅数据变化
    final listener = dbRef.onValue.listen((DatabaseEvent event) {
      if (event.snapshot.exists) {
        final data = event.snapshot.value;
        // 触发通知
        _showNotification('数据库更新', '数据已变更：${data.toString()}');
      }
    });

    // 保持任务存活（按需调整，避免过早结束）
    await Future.delayed(const Duration(minutes: 14));
    // 取消监听，避免内存泄漏
    listener.cancel();

    return Future.value(true);
  });
}

5. 启动后台任务 #

在应用首页或合适时机注册周期性后台任务（安卓最小周期为15分钟）：

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key});

  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  @override
  void initState() {
    super.initState();
    initNotifications();
    // 注册周期性任务
    Workmanager().registerPeriodicTask(
      'db_listener_task', // 唯一任务ID
      'db_listener', // 任务名称
      frequency: const Duration(minutes: 15),
      initialDelay: const Duration(seconds: 10),
      constraints: Constraints(
        networkType: NetworkType.connected, // 仅在联网时执行
      ),
    );
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('后台数据库监听')),
      body: const Center(child: Text('应用运行中...')),
    );
  }
}

关键注意事项 #

• 安卓配置：在AndroidManifest.xml中添加权限和WorkManager配置：

<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED"/>
<uses-permission android:name="android.permission.WAKE_LOCK"/>

<application>
  <!-- 移除默认WorkManager初始化，避免冲突 -->
  <provider
    android:name="androidx.work.impl.WorkManagerInitializer"
    android:authorities="${applicationId}.workmanager-init"
    tools:node="remove"/>
</application>

• iOS限制：iOS后台任务执行时间有限，无法长时间保持实时监听，建议结合Firebase Cloud Messaging推送辅助；需在Info.plist中添加后台模式：

<key>UIBackgroundModes</key>
<array>
  <string>fetch</string>
  <string>remote-notification</string>
</array>

• 电量优化：安卓系统可能因电量优化杀死后台任务，需引导用户关闭应用的电量优化设置。
• 监听清理：后台任务结束时务必取消数据库监听，防止内存泄漏。

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