Flutter firebase messaging onbackgroundmessage not working

Flutter Firebase Messaging onBackgroundMessage Not Working

The “onBackgroundMessage” function in Firebase Messaging is used to handle incoming messages when the app is in the background or terminated state. It allows you to perform custom actions and process the message data. However, there are certain limitations and requirements for this function to work correctly.

Possible Solutions:

  1. Check Firebase Messaging dependencies: Make sure you have installed and configured the firebase_messaging package in your Flutter project. You can add it to your pubspec.yaml file and run flutter packages get to install it properly.
  2. Enable background message handling: In your main.dart file, initialize Firebase Messaging and enable background message handling by adding the following code within your main function:


    This ensures that the function _firebaseMessagingBackgroundHandler is called when a background message is received.

  3. Implement the background message handler: Create a function named _firebaseMessagingBackgroundHandler where you can handle the received message. This function should have the following structure:

    Future _firebaseMessagingBackgroundHandler(RemoteMessage message) async {
      // Process the message here, perform custom actions, show notifications, etc.

    You can perform any necessary processing within this function, such as showing a notification or executing custom actions based on the received message.

  4. Testing onBackgroundMessage: It’s important to note that testing the onBackgroundMessage function is not possible using the default “flutter run” command. Instead, you need to create a release build and run it on a device or emulator to simulate the background behavior. Background message handling does not work in debug mode.
  5. Additional considerations: Make sure your app’s AndroidManifest.xml and iOS AppDelegate files are properly configured as per the Firebase Messaging documentation. Also, keep in mind that onBackgroundMessage is an Android-only feature and does not work on iOS. For iOS, Firebase Cloud Messaging handles background messages automatically.

Example Implementation:

Here is an example implementation of handling a background message using Firebase Messaging in Flutter:

import 'package:firebase_messaging/firebase_messaging.dart';

void main() {
  // Initialize Firebase Messaging


Future _firebaseMessagingBackgroundHandler(RemoteMessage message) async {
  print('Background message received: ${message.notification?.title ?? ''}');
  // Handle the message data, show a notification, execute actions, etc.

class MyApp extends StatelessWidget {
  // ...

By following the above steps and making sure your project is properly configured, you should be able to receive and handle background messages in your Flutter app using Firebase Messaging.

Leave a comment