Flutter后台模式下推送通知展示前修改内容的实现方案咨询

该方案完全不需要服务端存储不同用户对联系人的备注信息，所有备注替换逻辑都在本地完成，完全规避了笛卡尔积超大表的问题。

Android端核心逻辑 #

• 使用透传/数据类型推送而非通知类型推送：不要走推送通道的自动通知展示逻辑，服务端仅下发发送方唯一ID、群组ID这类必要元数据，通知的内容生成、展示完全由客户端本地控制。
• 注册推送消息接收服务：在AndroidManifest.xml中注册对应推送服务的消息回调，保证应用在前台、后台、被杀死状态下都能触发代码执行。如果用FCM，注册FirebaseMessagingService并重写onMessageReceived方法即可捕获所有推送数据；国内厂商推送同理，全部配置为透传消息模式，关闭通道自动弹窗能力。
• 本地替换内容生成通知：在推送回调中拿到发送方ID后，读取本地提前缓存的联系人ID-备注名映射，替换通知内容里的用户名变量，再调用本地通知API弹窗即可。

Flutter侧整合实现 #

你可以直接用成熟的第三方库实现全流程，无需单独写原生桥接代码，示例逻辑如下：

• 依赖firebase_messaging（推送接收）和flutter_local_notifications（本地通知生成），国内用户可替换为对应厂商推送的Flutter封装库。
• 后台/杀死状态的推送处理代码示例：

import 'package:firebase_messaging/firebase_messaging.dart';
import 'package:flutter_local_notifications/flutter_local_notifications.dart';

// 初始化本地通知实例
final FlutterLocalNotificationsPlugin flutterLocalNotificationsPlugin =
    FlutterLocalNotificationsPlugin();

// 后台推送消息监听回调
@pragma('vm:entry-point')
Future<void> _firebaseMessagingBackgroundHandler(RemoteMessage message) async {
  // 从推送元数据中获取发送方ID
  final String senderId = message.data['sender_id'] ?? '';
  // 查询本地缓存的发送方备注名
  final String senderName = await getLocalContactNameById(senderId);
  // 生成并展示通知
  await flutterLocalNotificationsPlugin.show(
    0,
    '群组新消息',
    '$senderName send a new message to the group!',
    const NotificationDetails(
      android: AndroidNotificationDetails(
        'group_message',
        '群组消息',
        importance: Importance.max,
        priority: Priority.high,
      ),
    ),
  );
}

// 应用启动时初始化配置
void initPushConfig() {
  // 注册后台推送回调
  FirebaseMessaging.onBackgroundMessage(_firebaseMessagingBackgroundHandler);
  // 前台推送回调同理处理即可
  FirebaseMessaging.onMessage.listen((RemoteMessage message) {
    // 同上逻辑生成通知
  });
}

• 本地联系人缓存优化：提前把同步到的系统联系人的ID和备注名映射存在本地SharedPreferences或者SQLite中，避免每次生成通知时都读取系统联系人，提升处理速度。

注意事项 #

• Android 13及以上系统需要提前申请POST_NOTIFICATIONS权限，否则本地生成的通知无法正常展示。
• 不要使用系统通知修改类服务实现该需求，兼容性极差，透传消息+本地生成通知的方案覆盖99%以上的Android设备，是当前最通用的实现方式。

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