Firebase聊天应用消息通知功能实现求助：应用内触发无通知

嘿，这个问题我之前踩过一模一样的坑！控制台能发通知但应用内发消息时没反应，本质是因为控制台是直接调用FCM的推送接口，而你自己发消息的时候只更新了数据库（比如Firestore/Realtime Database），没触发FCM的推送逻辑。下面给你整理一套靠谱的实现方案：

核心思路 #

要实现聊天消息触发推送，你需要：

1. 存储每个用户的FCM令牌（Token），这是推送的唯一目标标识
2. 在新消息写入数据库时，自动触发FCM推送逻辑（推荐用Firebase Cloud Functions，安全又省心）
3. 确保客户端能正确接收并展示通知

1. 先搞定用户FCM Token的存储 #

每个用户登录或Token更新时，必须把Token存在你的数据库里（比如Firestore的users集合）。因为你要给接收方发通知，得知道对方的Token才行。

举个Flutter的例子（其他平台逻辑类似）：

import 'package:firebase_messaging/firebase_messaging.dart';
import 'package:cloud_firestore/cloud_firestore.dart';

// 获取并更新用户的FCM Token
Future<void> updateUserFcmToken(String userId) async {
  String? token = await FirebaseMessaging.instance.getToken();
  if (token != null) {
    await FirebaseFirestore.instance.collection('users').doc(userId).update({
      'fcmToken': token,
    });
  }
}

// 监听Token变化，自动更新
FirebaseMessaging.instance.onTokenRefresh.listen((newToken) {
  updateUserFcmToken(currentUserId); // currentUserId是当前登录用户的ID
});

2. 用Cloud Functions自动触发推送（推荐方案） #

客户端直接调用FCM推送有安全风险（比如Token泄露），所以最好用Cloud Functions监听数据库的新消息事件，自动触发推送。

步骤1：初始化Cloud Functions

先安装Firebase CLI，然后在项目根目录执行：

firebase init functions

选择JavaScript/TypeScript，初始化项目。

步骤2：编写推送函数

打开functions/index.js，替换成下面的代码（根据你的数据库结构调整）：

const functions = require("firebase-functions");
const admin = require("firebase-admin");
admin.initializeApp();

// 监听messages集合的新消息，触发推送
exports.sendChatNotification = functions.firestore.document('messages/{messageId}')
    .onCreate(async (snap, context) => {
        const message = snap.data();
        const receiverUid = message.receiverUid; // 假设你的消息里存了接收方的UID
        const senderName = message.senderName; // 发送方昵称
        const messageContent = message.text ? message.text : '收到一张图片'; // 文本消息显示内容，图片消息显示提示

        // 从users集合获取接收方的FCM Token
        const userDoc = await admin.firestore().collection('users').doc(receiverUid).get();
        const fcmToken = userDoc.data()?.fcmToken;

        if (!fcmToken) {
            functions.logger.log(`接收方${receiverUid}没有存储FCM Token，跳过推送`);
            return null;
        }

        // 构建FCM推送内容
        const payload = {
            notification: {
                title: senderName,
                body: messageContent,
                clickAction: 'FLUTTER_NOTIFICATION_CLICK' // 适配Flutter点击跳转，Android/iOS原生可调整
            },
            data: {
                chatId: message.chatId, // 可选：传递聊天ID，方便点击通知后跳转到对应聊天界面
                messageId: context.params.messageId
            },
            token: fcmToken
        };

        // 发送通知
        try {
            await admin.messaging().send(payload);
            functions.logger.log(`通知已成功发送给${receiverUid}`);
            return null;
        } catch (error) {
            functions.logger.error(`发送通知失败：${error}`);
            return null;
        }
    });

步骤3：部署函数

执行命令部署到Firebase：

firebase deploy --only functions

3. 客户端配置通知接收 #

确保你的客户端已经正确配置FCM的接收逻辑，比如：

• Android：创建FirebaseMessagingService子类，处理通知的接收和点击
• iOS：配置APNs证书，开启推送权限，并实现UNUserNotificationCenterDelegate
• Flutter：用firebase_messaging插件，监听onMessage（前台接收）和onMessageOpenedApp（点击通知跳转）事件

4. 常见坑点排查 #

• 检查接收方的FCM Token是否正确存储在数据库里，有没有因为Token更新而未同步
• 查看Cloud Functions的日志（Firebase控制台→Functions→日志），看是否有报错（比如权限不足、Token无效）
• 确保消息文档里的receiverUid是正确的，没有写错
• 检查客户端是否开启了通知权限（Android要手动开启，iOS需要用户授权）

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