Android（Java）Firestore数据变更通知机制及后台实现咨询

我完全懂你的困扰——要让App在后台甚至未运行时，也能感知Firestore的文档新增/修改，然后给特定用户推送通知。直接在App里用Firestore的实时监听（比如addSnapshotListener）在后台根本不可靠，系统随时可能杀掉进程，所以必须用**云端触发器+Firebase Cloud Messaging（FCM）**的组合方案，下面一步步给你拆解实现步骤：

1. 前置准备：启用云端服务 #

先确认你的Firebase项目已经开启了Cloud Functions和Cloud Messaging服务，这俩是实现整个流程的核心基础。

2. 编写Cloud Functions触发器（监听Firestore变更） #

你需要写一个Node.js的云端函数，当Firestore指定集合的文档发生新增/更新时自动触发，然后通过FCM给目标设备发通知。

示例云端函数代码 #

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

// 监听"targetCollection"集合的文档新增/更新操作
exports.sendNotificationOnDocChange = functions.firestore
  .document("targetCollection/{docId}")
  .onWrite(async (change, context) => {
    // 获取变更后的文档数据，删除操作直接跳过
    const docData = change.after.exists ? change.after.data() : null;
    if (!docData) return;

    // 假设你的文档里存储了目标用户的FCM令牌数组（或者存用户ID，再去用户集合查令牌）
    const targetDeviceTokens = docData.targetUserTokens;
    if (!targetDeviceTokens || targetDeviceTokens.length === 0) return;

    // 构建FCM通知内容
    const notificationPayload = {
      notification: {
        title: "数据更新提醒",
        body: `${docData.content} 已更新`,
        clickAction: "OPEN_TARGET_ACTIVITY" // 点击通知要打开的Activity
      },
      data: {
        docId: context.params.docId, // 传递文档ID等额外数据
        updateType: "CONTENT_CHANGE"
      }
    };

    // 发送通知
    try {
      const sendResult = await admin.messaging().sendToDevice(targetDeviceTokens, notificationPayload);
      functions.logger.info("通知发送成功", sendResult);
    } catch (error) {
      functions.logger.error("通知发送失败", error);
    }
  });

部署云端函数 #

安装Firebase CLI后，在终端运行以下命令部署：

firebase deploy --only functions

3. Android端配置FCM，接收后台通知 #

接下来在Android项目里配置FCM，确保App在后台甚至未运行时能收到并处理通知。

3.1 添加FCM依赖 #

在app/build.gradle的dependencies块中添加：

implementation 'com.google.firebase:firebase-messaging:23.4.1'

3.2 创建FirebaseMessagingService子类 #

这个类负责处理FCM消息，不管App处于前台还是后台：

import com.google.firebase.messaging.FirebaseMessagingService;
import com.google.firebase.messaging.RemoteMessage;
import android.app.NotificationManager;
import android.app.PendingIntent;
import android.content.Context;
import android.content.Intent;
import android.media.RingtoneManager;
import android.net.Uri;
import androidx.core.app.NotificationCompat;
import java.util.Map;

public class MyFCMService extends FirebaseMessagingService {

    @Override
    public void onMessageReceived(RemoteMessage remoteMessage) {
        // 处理前台收到的消息，后台消息的notification字段会由系统直接展示
        if (remoteMessage.getNotification() != null) {
            showNotification(
                remoteMessage.getNotification().getTitle(),
                remoteMessage.getNotification().getBody(),
                remoteMessage.getData()
            );
        }
    }

    @Override
    public void onNewToken(String token) {
        // 每次获取到新的FCM令牌，都要保存到Firestore的用户文档中
        saveFcmTokenToFirestore(token);
    }

    private void showNotification(String title, String content, Map<String, String> extraData) {
        // 点击通知跳转的目标Activity
        Intent intent = new Intent(this, TargetActivity.class);
        intent.putExtras(extraData); // 传递FCM携带的额外数据
        intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
        PendingIntent pendingIntent = PendingIntent.getActivity(
            this,
            0,
            intent,
            PendingIntent.FLAG_ONE_SHOT | PendingIntent.FLAG_IMMUTABLE
        );

        String channelId = "YOUR_NOTIFICATION_CHANNEL_ID"; // 提前创建好的通知渠道ID
        Uri defaultSound = RingtoneManager.getDefaultUri(RingtoneManager.TYPE_NOTIFICATION);
        NotificationCompat.Builder notificationBuilder = new NotificationCompat.Builder(this, channelId)
                .setSmallIcon(R.drawable.ic_notification)
                .setContentTitle(title)
                .setContentText(content)
                .setAutoCancel(true)
                .setSound(defaultSound)
                .setContentIntent(pendingIntent);

        NotificationManager notificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
        notificationManager.notify(0, notificationBuilder.build());
    }

    private void saveFcmTokenToFirestore(String token) {
        // 这里实现将令牌保存到Firestore的逻辑，比如更新当前用户文档的fcmToken字段
        // FirebaseFirestore.getInstance().collection("users").document(currentUserId).update("fcmToken", token);
    }
}

3.3 在Manifest中注册Service #

在<application>标签内添加：

<service
    android:name=".MyFCMService"
    android:exported="false">
    <intent-filter>
        <action android:name="com.google.firebase.MESSAGING_EVENT" />
    </intent-filter>
</service>

4. 关键注意事项 #

• FCM令牌管理：设备的FCM令牌可能会变化，一定要在onNewToken方法里更新Firestore中的令牌，确保云端能拿到正确的推送目标。
• 通知渠道要求：Android 8.0及以上必须创建通知渠道，你已经了解这块，确保提前配置完成。
• 后台消息行为：App在后台时，FCM的notification字段会由系统直接展示通知，data字段会在用户点击通知后传递到目标Activity；前台收到消息则会走到onMessageReceived中处理。
• 云端权限：默认初始化的admin SDK拥有足够权限访问Firestore和发送FCM消息，若使用自定义服务账号，需配置好对应角色。

这样配置后，每当Firestore的目标集合有文档新增或修改，云端函数就会自动触发，通过FCM将通知推送到指定设备，不管你的App是否在运行都能收到通知。

内容的提问来源于stack exchange，提问作者André Lindström