如何通过Firebase推送通知携带Firestore文档并跳转至详情页

核心思路 #

受限于推送payload的大小限制，无法直接在通知里附带整个Firestore文档，正确做法是携带文档的唯一标识，用户点击通知后，用这个标识去Firestore拉取完整的商家数据。

1. 在推送payload中添加文档标识 #

构造FCM推送请求时，在data字段里加入自定义参数，指定Firestore的集合路径和文档ID：

示例payload结构：

{
  "notification": {
    "title": "限时折扣来袭",
    "body": "点击查看XX商家专属优惠"
  },
  "data": {
    "page_type": "merchant_detail",
    "collection_path": "merchants",
    "doc_id": "your_merchant_document_id"
  },
  "token": "target_user_fcm_token"
}

• collection_path：Firestore中商家数据所在的集合名称
• doc_id：对应商家的文档ID
• page_type：用来区分跳转的页面类型（多页面场景下可选）

2. 监听通知点击并传递参数 #

根据移动端平台，处理通知点击事件，取出data里的参数：

Android端 #

• 前台收到通知：在FirebaseMessagingService的onMessageReceived方法中，直接从RemoteMessage的data属性获取参数，启动详情页并通过Intent传递。
• 后台收到通知：系统自动启动配置的默认Activity，在该Activity的onCreate或onNewIntent中，从Intent的extras里取出参数。

iOS端 #

在UNUserNotificationCenterDelegate的didReceiveNotificationResponse方法中，从response.notification.request.content.userInfo里提取自定义参数。

3. 详情页加载Firestore数据 #

跳转到详情页后，用拿到的集合路径和文档ID，请求Firestore获取对应商家数据：

Android示例（Kotlin） #

class MerchantDetailActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_merchant_detail)

        // 从Intent中取出参数
        val collectionPath = intent.getStringExtra("collection_path") ?: "merchants"
        val docId = intent.getStringExtra("doc_id") ?: return

        // 初始化Firestore并获取文档
        val db = FirebaseFirestore.getInstance()
        db.collection(collectionPath).document(docId)
            .get()
            .addOnSuccessListener { document ->
                if (document.exists()) {
                    // 解析数据并更新UI
                    val merchantName = document.getString("name")
                    val discount = document.getString("discount_info")
                    val expireTime = document.getDate("expire_time")
                    tvMerchantName.text = merchantName
                    tvDiscount.text = discount
                    // ... 其他UI赋值操作
                } else {
                    // 处理文档不存在的情况，比如提示用户
                }
            }
            .addOnFailureListener {
                // 处理网络请求失败，弹出错误提示
            }
    }
}

iOS示例（Swift） #

class MerchantDetailViewController: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()
        // 假设参数从通知点击回调中传递到UserDefaults
        guard let collectionPath = UserDefaults.standard.string(forKey: "collection_path"),
              let docId = UserDefaults.standard.string(forKey: "doc_id") else { return }
        
        let db = Firestore.firestore()
        db.collection(collectionPath).document(docId).getDocument { [weak self] document, error in
            guard let self = self else { return }
            if let document = document, document.exists {
                let data = document.data()
                let merchantName = data?["name"] as? String
                let discount = data?["discount_info"] as? String
                self.merchantNameLabel.text = merchantName
                self.discountLabel.text = discount
                // ... 其他UI更新操作
            } else {
                // 处理文档不存在的情况
            }
        }
    }
}

关键注意事项 #

• 配置Firestore安全规则，确保移动端能正常读取目标文档，比如允许已认证用户访问：

  rules_version = '2';
  service cloud.firestore {
    match /databases/{database}/documents {
      match /merchants/{merchantId} {
        allow read: if request.auth != null;
      }
    }
  }
  

• 推送payload的data字段有大小限制（Android约4KB，iOS约5KB），只传必要的标识，不要附带大量数据。
• 处理离线场景：可提前缓存常用商家数据，或在离线时提示用户无法加载详情。

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