[firebase_messaging]: Android: dismissing a notification delivers an empty RemoteMessage to onMessage (Firebase's NOTIFICATION_DISMISS broadcast is read as a message)

Đang mở
  • Có gì không ổn?
#18,897 1 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

@akashdh11 đang làm issue này rồi.

Từ ngày 3/11/2026.

  • #18898 của @akashdh11 — đã đóng, không merge
  • #18899 của @akashdh11 — đang mở
  • #18907 của @Lyokone — đang mở

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
38/100
Loại issue
Lỗi
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Đình trệ
Công nghệ
android, dart, firebase
Lĩnh vực
backend-api-design, mobile

Hướng nghiên cứu

Read FlutterFirebaseMessagingReceiver.onReceive in the Android implementation of firebase_messaging and compare its handling of wrapped_intent with Firebase's CloudMessagingReceiver. Reproduce by dismissing a notification while listening to FirebaseMessaging.onMessage; done means dismissals no longer deliver an empty RemoteMessage. The issue has two linked pull requests, including one still open.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

Is there an existing issue for this?
  • I have searched the existing issues.

This is very likely the cause of #16954. That issue was closed as stale because nobody could reproduce it.

Which plugins are affected?

Messaging

Which platforms are affected?

Android

Description

On Android, FlutterFirebaseMessagingReceiver treats Firebase's own "notification dismissed" broadcast as a new message. Each time the user dismisses (swipes away, or "Clear all") a notification that the Firebase SDK displayed, the plugin builds a RemoteMessage from that broadcast. It has nothing in it:

{senderId: null, category: null, collapseKey: null, contentAvailable: false, data: {},
 from: null, messageId: null, messageType: null, mutableContent: false,
 notification: null, sentTime: 0, threadId: null, ttl: 0}
  • App in the foreground: FirebaseMessaging.onMessage fires with this empty message, once per dismissed notification. An app that draws its own notification for foreground messages (for example with flutter_local_notifications) shows a blank notification each time. Android lists it as "Custom app notification" in its notification history.
  • App in the background: the same empty message goes down the background path. From the receiver's code, that means onBackgroundMessage receives it when one is registered; our app registers none, so we see the plugin's "no onBackgroundMessage handler" warning instead.

Cause. firebase-messaging's CommonNotificationBuilder builds a displayed notification's delete intent as a com.google.android.c2dm.intent.RECEIVE broadcast to the app. The real com.google.firebase.messaging.NOTIFICATION_DISMISS intent sits inside it, in the wrapped_intent extra.

  • Google's CloudMessagingReceiver, the base of FirebaseInstanceIdReceiver, checks wrapped_intent first. If it holds an Intent, the broadcast is a notification event: a dismissal goes to onNotificationDismissed (which logs the _nd analytics event), and it is never handled as a message.
  • FlutterFirebaseMessagingReceiver is registered for the same action, but has no such check. It goes straight to new RemoteMessage(intent.getExtras()).

Proposed fix. In FlutterFirebaseMessagingReceiver.onReceive, ignore a broadcast whose wrapped_intent extra is an Intent, as CloudMessagingReceiver does. I'll open a PR.

Reproducing the issue
  1. Use any app with firebase_messaging on Android that logs foreground messages, for example: 
    FirebaseMessaging.onMessage.listen((m) => debugPrint('onMessage ${m.toMap()}'));
  2. Put the app in the background (Home).
  3. Send the device a notification message, i.e. one with a notification payload (FCM v1: {"message": {"token": "<token>", "notification": {"title": "Test", "body": "Hello"}}}). Firebase displays it.
  4. Open the app from the launcher, not by tapping the notification, so it is in the foreground.
  5. Pull down the notification shade and swipe the notification away, or tap "Clear all".
  6. onMessage fires at once with the empty RemoteMessage above, once per dismissed notification.

Reproduced every time on:

  • a Pixel 11 Pro (Android 17, Google Play services 26.43.30), with the app installed from Play;
  • the Android 17 emulator (sdk_gphone16k_arm64), with a debug build.
Firebase Core version

4.15.2

Flutter Version

3.47.9

Relevant Log Output
# For each notification dismissed while the app is open:
D FLTFireMsgReceiver: broadcast received for message
I flutter : onMessage {senderId: null, ..., data: {}, messageId: null, notification: null, sentTime: 0, ...}
D FirebaseMessaging: Logging to scion event=_nd scionPayload=Bundle[{label=...}]

_nd is Firebase's notification_dismiss analytics event, logged by FirebaseInstanceIdReceiver for the same broadcast.

Flutter dependencies
  • firebase_messaging 16.7.1, firebase_core 4.15.2.
  • Android: firebase-messaging 25.1.3, play-services-cloud-messaging 17.4.0.
  • flutter_local_notifications 22.3.3, used to draw foreground notifications.

FlutterFirebaseMessagingReceiver.onReceive is the same in 17.0.1 and on main.

Additional context and comments

The FlutterFire docs' foreground example only draws a notification when message.notification != null. That is probably why most apps never notice: they silently ignore the empty message. It still reaches every onMessage listener, though, and every onBackgroundMessage handler.

Ngôn ngữ chính
Dart
Star
9.3k
Fork
4.1k
Merge trung bình
1 ngày 9 giờ
Pull request đã merge (30 ngày)
69

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của firebase/flutterfire

Tất cả issue của firebase/flutterfire

Issue tương tự

Thêm issue về Dart

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.