原生移动开发 / 系统课时

从 FCM 通知跳转业务页

从 FCM 通知跳转业务页

这一课解决“用户点了推送却没有准确落到业务页”的问题。核心是统一解析推送参数,并让冷启动、应用已运行、重复点击和未登录状态都进入可预期的处理分支。

学习目标

  • 能从 FCM 点击 Intent 中读取并校验业务参数。
  • 能区分冷启动与已有 Activity 的处理入口。
  • 能为未登录、重复点击等情况设计安全的降级路径。

先统一推送参数

业务跳转不要直接信任推送里传来的页面字符串。建议至少携带一个稳定的业务标识,例如订单号或消息 ID,并把目标类型限制在应用支持的集合中。

常见做法是让服务端发送 type、id、dedupeId 等数据;Android 端只根据这些字段决定进入哪个业务页面。不要把完整 URL 当成内部路由的唯一依据。

FCM 通知点击到业务页的处理分支

在 Activity 中处理点击参数

FCM 通知点击后,业务参数通常会进入启动目标 Activity 的 Intent。冷启动主要在 onCreate() 读取;Activity 已存在时,还需要处理 onNewIntent(),否则第二次点击可能仍使用旧 Intent。

下面是 Kotlin 的片段示例,假定通知点击最终进入 MainActivity。代码把入口统一到一个方法,并用 dedupeId 防止同一消息被重复消费。

kotlin
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))
    }
}

预期结果:

text
首次点击:读取 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 负责解析入口参数,业务层负责登录、权限和数据校验。这样即使任务栈或应用进程状态变化,跳转逻辑仍然可控。

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

目录与阅读设置

阅读设置

17

记录一个想法

从 FCM 通知跳转业务页

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

登录哪都通