Android系统托盘FCM通知处理：如何获取通知ID移除指定通知

这个需求在即时通讯类App里太常见了，核心思路就是把notificationId和你要追踪的对话做唯一绑定，这样就能精准找到对应ID来取消，而不是一刀切清掉所有通知。下面给你几种实用的实现方案：

方案一：用对话的唯一ID直接作为notificationId #

这是最直接的方式——如果你的对话本身有唯一标识（比如数据库里的自增conversationId，或者后端返回的唯一对话ID），直接把它转成整数作为notificationId即可。

发送通知时： #

// 假设conversationId是后端/数据库返回的唯一对话ID（数字类型）
int notificationId = (int) conversationId;

// 构建通知
NotificationCompat.Builder builder = new NotificationCompat.Builder(context, YOUR_CHANNEL_ID)
        .setSmallIcon(R.drawable.ic_msg_notification)
        .setContentTitle("新消息提醒")
        .setContentText("来自对话X的新消息")
        .setPriority(NotificationCompat.PRIORITY_DEFAULT)
        .setAutoCancel(false); // 不要自动取消，留到用户查看对话后手动取消

// 发送通知
NotificationManagerCompat notificationManager = NotificationManagerCompat.from(context);
notificationManager.notify(notificationId, builder.build());

用户查看对话后取消： #

当用户打开对应对话页面时，获取当前对话的conversationId，直接用它调用cancel：

// 获取当前打开的对话ID
long currentConversationId = getOpenedConversationId();
NotificationManagerCompat notificationManager = NotificationManagerCompat.from(context);
// 转成int类型（如果conversationId是long，注意范围不要超过int的最大值，或者直接用long型的notify重载）
notificationManager.cancel((int) currentConversationId);

注意：如果你的对话ID是字符串类型，可以用它的hashCode()转成int，但要注意极小概率的哈希冲突问题。如果追求绝对可靠，可以把字符串ID映射成数据库里的自增整数ID再使用。

方案二：存储notificationId与对话ID的关联关系 #

如果对话ID不适合直接作为notificationId（比如是超长字符串、UUID等），可以生成独立的notificationId，然后把它和对话ID的对应关系存在本地存储（比如SharedPreferences、Room数据库）。

发送通知时： #

// 生成唯一的notificationId，比如用当前时间戳（保证每次都是唯一的）
int notificationId = (int) System.currentTimeMillis();

// 存储对话ID和notificationId的关联，这里用SharedPreferences举例
SharedPreferences notificationPrefs = context.getSharedPreferences("NotificationMap", Context.MODE_PRIVATE);
notificationPrefs.edit()
        .putInt("conv_" + targetConversationId, notificationId)
        .apply();

// 构建并发送通知
NotificationCompat.Builder builder = ...;
NotificationManagerCompat.from(context).notify(notificationId, builder.build());

用户查看对话后取消： #

long currentConversationId = getOpenedConversationId();
SharedPreferences notificationPrefs = context.getSharedPreferences("NotificationMap", Context.MODE_PRIVATE);

// 查询对应的notificationId
int targetNotificationId = notificationPrefs.getInt("conv_" + currentConversationId, -1);
if (targetNotificationId != -1) {
    // 取消通知
    NotificationManagerCompat.from(context).cancel(targetNotificationId);
    // 清理关联记录，避免冗余
    notificationPrefs.edit().remove("conv_" + currentConversationId).apply();
}

方案三：从FCM payload中携带关联标识 #

如果你的通知是通过FCM推送的，可以让服务器在data payload里携带对话ID（甚至直接指定notificationId），客户端收到消息后直接用这个标识作为notificationId发送通知，后续取消时直接复用即可。

服务器发送的payload示例： #

{
  "data": {
    "conversationId": "1001",
    "messageContent": "今晚一起吃饭？",
    "senderName": "张三"
  },
  "to": "用户的FCM Token"
}

客户端接收并发送通知： #

@Override
public void onMessageReceived(RemoteMessage remoteMessage) {
    if (remoteMessage.getData().isEmpty()) return;

    // 从data中取出对话ID
    String conversationId = remoteMessage.getData().get("conversationId");
    int notificationId = Integer.parseInt(conversationId);

    // 构建通知并发送
    NotificationCompat.Builder builder = new NotificationCompat.Builder(context, YOUR_CHANNEL_ID)
            .setSmallIcon(R.drawable.ic_msg_notification)
            .setContentTitle(remoteMessage.getData().get("senderName"))
            .setContentText(remoteMessage.getData().get("messageContent"))
            .setPriority(NotificationCompat.PRIORITY_DEFAULT);

    NotificationManagerCompat.from(context).notify(notificationId, builder.build());
}

取消通知： #

和方案一一样，用户打开对话时获取conversationId，转成int后调用cancel即可。

额外注意事项 #

• 如果同一个对话有多条未读消息，建议复用同一个notificationId，这样新通知会替换旧通知，避免系统托盘里堆积同对话的多条通知，同时取消时也只需一次操作。
• 如果使用long型的对话ID，注意不要超过int的最大值（2^31-1），如果超过可以用NotificationManager.notify(String tag, int id, Notification notification)，用对话ID作为tag，这样就不用局限于int类型的ID了。

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