Flutter后台处理FCM时触发No Firebase App '[DEFAULT]'初始化错误

错误原因 #

1. FCM后台消息处理程序运行在独立隔离线程中，和主应用的Firebase初始化上下文不共享，哪怕主入口已经初始化Firebase，后台线程也无法识别。
2. 手动实例化_MyAppState属于错误操作——Flutter的State类必须由框架创建管理，直接new的实例没有正确上下文，无法正常调用依赖Widget环境的方法。

修复方案 #

1. 在后台处理函数中重新初始化Firebase #

必须在_firebaseMessagingBackgroundHandler开头调用Firebase.initializeApp()，确保隔离线程内的Firebase实例正常初始化。

2. 拆分本地通知逻辑，脱离State依赖 #

把sendLocalNotification改为全局函数或静态方法，避免绑定State对象——后台环境没有Widget树，无法访问State的上下文与资源。

修复后的完整代码 #

import 'package:firebase_core/firebase_core.dart';
import 'package:firebase_messaging/firebase_messaging.dart';
import 'package:flutter/material.dart';
import 'package:flutter_local_notifications/flutter_local_notifications.dart';

// 全局实例化本地通知插件，确保后台可访问
final FlutterLocalNotificationsPlugin flutterLocalNotificationsPlugin =
    FlutterLocalNotificationsPlugin();

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  
  // 主应用中初始化本地通知配置
  const AndroidInitializationSettings initializationSettingsAndroid =
      AndroidInitializationSettings('@mipmap/ic_launcher');
  const InitializationSettings initializationSettings =
      InitializationSettings(android: initializationSettingsAndroid);
  await flutterLocalNotificationsPlugin.initialize(initializationSettings);

  FirebaseMessaging.onBackgroundMessage(_firebaseMessagingBackgroundHandler);
  runApp(const MyApp());
}

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

  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  final FirebaseMessaging firebaseMessaging = FirebaseMessaging.instance;

  @override
  void initState() {
    super.initState();
    // 前台消息可在此调用本地通知
    FirebaseMessaging.onMessage.listen(sendLocalNotification);
  }
}

// 全局本地通知发送函数，不依赖State
void sendLocalNotification(RemoteMessage message) async {
  const AndroidNotificationDetails androidNotificationDetails =
      AndroidNotificationDetails(
    'your_channel_id',
    'your_channel_name',
    channelDescription: 'your_channel_description',
    importance: Importance.max,
    priority: Priority.high,
    ticker: 'ticker',
  );
  const NotificationDetails notificationDetails =
      NotificationDetails(android: androidNotificationDetails);
  await flutterLocalNotificationsPlugin.show(
    0,
    message.notification?.title ?? '通知标题',
    message.notification?.body ?? '通知内容',
    notificationDetails,
    payload: 'item x',
  );
}

Future<void> _firebaseMessagingBackgroundHandler(RemoteMessage message) async {
  // 后台线程必须单独初始化Firebase
  await Firebase.initializeApp();
  // 调用全局本地通知函数
  sendLocalNotification(message);
}

额外注意事项 #

• Android 8.0+必须配置通知渠道，否则无法显示本地通知。
• 确保flutter_local_notifications插件版本与Flutter版本适配，插件需支持后台运行。

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