Flutter集成Firebase Messaging无法接收云函数推送通知

核心问题分析 #

你遇到的控制台能发通知但云函数发不了的情况，大概率是以下几个关键问题导致的：

1. 云函数未返回Promise，导致异步操作提前终止 #

原云函数中，admin.messaging().sendToTopic是异步操作，但函数没有返回这个Promise，Firebase会在函数执行到末尾直接终止，消息可能还没发送完成就被中断了。

修正后的云函数代码

const functions = require("firebase-functions");
const admin = require('firebase-admin');

admin.initializeApp();

exports.chatNotifications = functions.firestore.document("chat/{docId}").onCreate(
    (snapshot, context) => {
        // 返回Promise确保函数等待消息发送完成，同时捕获错误便于排查
        return admin.messaging().sendToTopic(
            "chat", 
            {
                notification: {title: "新消息", body: "有一条新消息已发送"}, 
                data: {click_action: "FLUTTER_NOTIFICATION_CLICK"},
            }
        ).catch(error => {
            console.error('发送通知失败:', error);
            throw error; // 抛出错误让Firebase记录日志
        });
    }
);

2. Flutter端代码存在语法与初始化错误 #

原Flutter代码有两个致命问题：

• void main{...}是语法错误，正确写法是void main() async {...}
• 未初始化Firebase核心，且后台消息处理器中也需要初始化Firebase

修正后的Flutter代码

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

Future<void> backgroundHandler(RemoteMessage message) async {
  await Firebase.initializeApp(); // 后台处理时必须初始化Firebase
  print('后台收到通知内容: ${message.notification?.body}');
}

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp(); // 初始化Firebase核心

  // 订阅主题（确保异步等待完成）
  await FirebaseMessaging.instance.subscribeToTopic("chat");
  
  // 注册后台消息处理器
  FirebaseMessaging.onBackgroundMessage(backgroundHandler);

  runApp(const MyApp()); // 替换成你的应用根组件
}

3. 额外检查点 #

• 确认云函数已正确部署：执行firebase deploy --only functions，并在Firebase控制台查看函数状态是否为"活跃"
• 查看云函数日志：在Firebase控制台的函数页面，检查是否有发送失败的错误日志
• 确认通知权限：iOS端需主动请求用户授权通知权限，Android端确保AndroidManifest.xml中配置了正确的权限与服务
• 验证主题订阅状态：可以通过FirebaseMessaging.instance.getToken()获取设备token，在Firebase控制台测试向该token发送"chat"主题的消息，确认设备能正常接收

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