原生移动开发 / 系统课时

看懂 FCM 推送完整链路

看懂 FCM 推送完整链路

FCM 推送不是“业务服务直接调用手机”的直连过程,而是业务服务、FCM 后端、平台传输层和 Android 客户端协同完成的消息链路。本篇把 Token、发送请求和客户端接收三个关键位置串起来,帮助你定位消息到底卡在哪里。

学习目标

  • 能说清业务服务、FCM、设备注册 Token 与 Android 客户端之间的关系。
  • 能区分“发送成功”和“客户端已经处理消息”这两个不同阶段。
  • 能用一个 HTTP v1 请求理解单设备消息从服务端发出的基本格式。

从 Token 开始建立链路

Android 客户端接入 FCM 后,会获得用于定位应用实例的注册 Token;Token 可能发生变化,应用应通过 onNewToken 处理更新并把最新值同步给自己的业务服务。Firebase 官方架构把流程概括为:客户端注册并获得 Token,业务服务把消息请求发送到 FCM 后端,FCM 再交给平台传输层,最终由设备上的 FCM SDK 交给应用或系统通知处理。([Firebase][5])

FCM 推送完整消息链路

服务端究竟发送给谁

FCM 后端不会替业务系统决定业务对象。业务服务需要先根据自己的用户、设备或订阅关系选出目标,再把消息请求交给 FCM。FCM 支持以 registration token、topic、condition 等作为目标;单设备场景最容易理解,因为一个请求可以明确对应某个应用实例。([Firebase][6])

使用 HTTP v1 时,请求目标是项目下的 messages:send 接口,需要经过 OAuth 2.0 授权。下面是一个发送到单个 registration token 的完整请求形态;<ACCESS_TOKEN>、<PROJECT_ID> 和 <REGISTRATION_TOKEN> 都必须替换为实际值。([Firebase][7])

bash
curl -X POST \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json; UTF-8" \
  -d '{
    "message": {
      "token": "<REGISTRATION_TOKEN>",
      "notification": {
        "title": "FCM 测试",
        "body": "消息链路验证成功"
      }
    }
  }' \
  "https://fcm.googleapis.com/v1/projects/<PROJECT_ID>/messages:send"

预期结果:

text
HTTP/1.1 200 OK
{
  "name": "projects/<PROJECT_ID>/messages/<MESSAGE_ID>"
}

这里的 200 OK 和 message ID 只说明 FCM 已接受这次发送请求,不等于你的 Android 业务代码已经完成处理。真正的问题定位需要继续观察设备侧接收情况。Firebase 的 HTTP v1 API 文档将成功响应定义为包含消息名称的对象。([Firebase][7])

到达 Android 后并不只有一条路径

客户端接收行为与消息类型以及应用前后台状态有关。Android 官方文档指出,前台时 notification、data 或两者组合都可以进入 onMessageReceived;应用后台时,纯 notification 通常由系统放入通知栏,而 notification+data 会由通知栏显示,同时 data 可进入启动 Activity 的 Intent extras。纯 data 消息则进入 onMessageReceived,但后台处理时间窗口有限。([Firebase][8])

因此排查推送时,至少要分成三个阶段:Token 是否正确并已同步、FCM 是否接受发送请求、Android 客户端是否按当前消息类型和应用状态处理消息。任何一个阶段出问题,都可能表现成“用户没有收到通知”,但根因完全不同。

不要把 FCM 当成普通 HTTP 回调

业务服务发送的是一条受 FCM 规则管理的消息,设备是否在线、消息类型、应用前后台状态以及 Android 的后台执行限制都会影响最终表现。对于耗时处理,不应把大量工作直接塞进 onMessageReceived,因为该回调具有有限的执行窗口,Firebase 官方也明确提醒后台执行限制可能导致处理暂停或进程结束。([Firebase][8])

实际项目中,业务服务保存最新 Token,发送层记录 FCM 请求结果,客户端记录接收与处理日志,这三处日志串起来后,才能判断问题发生在“没有目标”“没有成功提交”“没有到设备”还是“已经到设备但应用没有按预期处理”。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

看懂 FCM 推送完整链路

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通