Flutter Firebase后台/关闭状态收通知：弹窗展示问题求助

一、后台消息处理的_TypeError（空检查运算符用于空值）问题 #

这个错误90%是因为后台消息处理函数违反了Firebase的运行规则，或者在函数里直接操作了空值导致的，按以下步骤排查修复：

1. 确保后台处理函数是顶级函数 #

后台消息是在Flutter引擎之外的隔离线程运行，无法访问类的成员变量、BuildContext或任何依赖Flutter环境的对象，所以_firebaseMessagingBackgroundHandler必须定义在所有类之外：

// 必须是顶级函数，不能放在State或类内部
Future<void> _firebaseMessagingBackgroundHandler(RemoteMessage message) async {
  // 后台环境必须手动初始化Firebase
  await Firebase.initializeApp();
  // 这里只能写纯Dart代码，不能调用Flutter UI相关API（比如showDialog）
}

2. 避免强制空解包（!） #

后台推送的消息字段可能为空（比如自定义data字段缺失、notification字段为空），直接用!会触发空检查错误，改成安全访问：

// 错误写法：强制解包可能为空的字段
var title = message.notification!.title!;

// 正确写法：使用??提供默认值，或者先判断非空
var title = message.notification?.title ?? '未知通知';
var body = message.notification?.body ?? '';
var customData = message.data['key'] ?? '默认值';

3. 后台函数禁止调用Flutter框架API #

后台线程没有Flutter上下文，不能调用showDialog、Navigator、setState等UI相关方法，也不能访问需要Flutter初始化的插件（比如部分状态管理库），只能做数据存储、网络请求这类纯Dart操作。

二、后台/锁屏状态收消息，打开应用时弹窗展示内容 #

后台状态下无法直接弹窗，需要先把消息存到本地，等应用回到前台时读取并弹窗：

1. 后台存储消息 #

在后台处理函数里用SharedPreferences存储消息内容：

Future<void> _firebaseMessagingBackgroundHandler(RemoteMessage message) async {
  await Firebase.initializeApp();
  final prefs = await SharedPreferences.getInstance();
  // 将消息转为JSON字符串存储，方便后续解析
  await prefs.setString('pending_notification', jsonEncode({
    'title': message.notification?.title ?? '通知',
    'body': message.notification?.body ?? '',
    'data': message.data,
  }));
}

2. 前台监听应用状态，触发弹窗 #

在应用初始化或首页添加生命周期监听，当应用从后台回到前台时，读取存储的消息并弹窗：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  // 初始化SharedPreferences
  final prefs = await SharedPreferences.getInstance();
  // 配置后台消息处理
  FirebaseMessaging.onBackgroundMessage(_firebaseMessagingBackgroundHandler);
  
  runApp(MyApp(pendingMsg: prefs.getString('pending_notification')));
}

class MyApp extends StatefulWidget {
  final String? pendingMsg;
  const MyApp({super.key, this.pendingMsg});

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> with WidgetsBindingObserver {
  String? _pendingMsg;

  @override
  void initState() {
    super.initState();
    WidgetsBinding.instance.addObserver(this);
    _pendingMsg = widget.pendingMsg;
    // 应用启动时检查是否有未处理的通知
    WidgetsBinding.instance.addPostFrameCallback((_) => _showMsgDialog());
  }

  @override
  void didChangeAppLifecycleState(AppLifecycleState state) {
    super.didChangeAppLifecycleState(state);
    // 应用从后台回到前台时触发检查
    if (state == AppLifecycleState.resumed) {
      _checkPendingMsg();
    }
  }

  Future<void> _checkPendingMsg() async {
    final prefs = await SharedPreferences.getInstance();
    final msgJson = prefs.getString('pending_notification');
    if (msgJson != null) {
      setState(() => _pendingMsg = msgJson);
      _showMsgDialog();
      // 展示后清除存储，避免重复弹窗
      await prefs.remove('pending_notification');
    }
  }

  void _showMsgDialog() {
    if (_pendingMsg == null) return;
    final msg = jsonDecode(_pendingMsg!);
    showDialog(
      context: context,
      builder: (_) => AlertDialog(
        title: Text(msg['title']),
        content: Text(msg['body']),
        actions: [
          TextButton(
            onPressed: () => Navigator.pop(context),
            child: const Text('确定'),
          ),
        ],
      ),
    );
  }

  @override
  void dispose() {
    WidgetsBinding.instance.removeObserver(this);
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: const Text('推送示例')),
        body: const Center(child: Text('等待通知...')),
      ),
    );
  }
}

额外注意事项 #

• 测试后台消息时，不能用热重载/热重启，必须完全重启应用并切到后台，再通过Firebase控制台发送测试消息。
• iOS需要在Xcode中开启Background Modes的Remote notifications权限，Info.plist配置推送相关权限。
• Android 13及以上需要动态申请POST_NOTIFICATIONS权限，否则后台通知可能不展示。

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