原生移动开发 / 系统课时
从 FCM 通知跳转业务页
从 FCM 通知跳转业务页
这一课解决“用户点了推送却没有准确落到业务页”的问题。核心是统一解析推送参数,并让冷启动、应用已运行、重复点击和未登录状态都进入可预期的处理分支。
学习目标
- 能从 FCM 点击 Intent 中读取并校验业务参数。
- 能区分冷启动与已有 Activity 的处理入口。
- 能为未登录、重复点击等情况设计安全的降级路径。
先统一推送参数
业务跳转不要直接信任推送里传来的页面字符串。建议至少携带一个稳定的业务标识,例如订单号或消息 ID,并把目标类型限制在应用支持的集合中。
常见做法是让服务端发送 type、id、dedupeId 等数据;Android 端只根据这些字段决定进入哪个业务页面。不要把完整 URL 当成内部路由的唯一依据。

在 Activity 中处理点击参数
FCM 通知点击后,业务参数通常会进入启动目标 Activity 的 Intent。冷启动主要在 onCreate() 读取;Activity 已存在时,还需要处理 onNewIntent(),否则第二次点击可能仍使用旧 Intent。
下面是 Kotlin 的片段示例,假定通知点击最终进入 MainActivity。代码把入口统一到一个方法,并用 dedupeId 防止同一消息被重复消费。
class MainActivity : AppCompatActivity() {
private var lastDedupeId: String? = null
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
handlePushIntent(intent)
}
override fun onNewIntent(intent: Intent) {
super.onNewIntent(intent)
setIntent(intent)
handlePushIntent(intent)
}
private fun handlePushIntent(intent: Intent) {
val type = intent.getStringExtra("type") ?: return
val id = intent.getStringExtra("id") ?: return
val dedupeId = intent.getStringExtra("dedupeId") ?: "$type:$id"
if (dedupeId == lastDedupeId) return
lastDedupeId = dedupeId
// 只接受应用已定义的业务类型,避免外部参数直接决定任意页面。
when (type) {
"order" -> openOrder(id)
"message" -> openMessage(id)
}
}
private fun openOrder(id: String) {
startActivity(Intent(this, OrderDetailActivity::class.java).putExtra("orderId", id))
}
private fun openMessage(id: String) {
startActivity(Intent(this, MessageDetailActivity::class.java).putExtra("messageId", id))
}
}预期结果:
首次点击:读取 type/id/dedupeId,并进入对应业务页
已有 Activity 再次点击:通过 onNewIntent() 重新解析参数
相同 dedupeId 再次点击:直接忽略,不重复打开业务页处理未登录与冷启动
跳转逻辑应先判断“是否具备访问目标页的登录态”,再决定进入业务页还是登录页。未登录时不要把业务 ID 丢掉,可以暂存为待处理路由;登录成功后再消费一次。
冷启动与热启动的关键区别不是“页面长什么样”,而是入口方法不同。使用 onCreate() 与 onNewIntent() 统一处理后,业务层就不用关心 Activity 是新建还是复用。
对于需要登录的订单详情,可以把 type=order、id=<ID>、dedupeId=<ID> 保存到内存或持久化待处理数据中,并在登录完成后再次校验业务 ID。实际项目中还应检查用户是否有权访问该对象。
处理重复点击与非法参数
通知可能因为用户快速连续点击、系统恢复任务栈或第三方厂商行为而重复进入。不要只依赖 Activity 的生命周期判断是否重复,最好使用稳定的消息 ID 做幂等控制。
推送参数还必须做白名单校验。未知的 type、缺少 id、格式不合法的业务 ID 都应直接忽略或进入安全页面,而不是动态拼接 Activity 类名或任意深链地址。
验证四种实际情况
测试时至少覆盖四条路径:应用关闭后点击通知、应用已在前台时再次点击、用户未登录时点击,以及同一通知快速连续点击。每条路径都应记录 dedupeId 和最终路由,方便排查“通知到了但页面没打开”的问题。
最终的职责边界应保持简单:FCM 负责把消息送到设备,通知点击负责提供入口,Activity 负责解析入口参数,业务层负责登录、权限和数据校验。这样即使任务栈或应用进程状态变化,跳转逻辑仍然可控。