原生移动开发 / 系统课时
处理前后台消息差异
处理前后台消息差异
FCM 消息在应用前台、后台和进程尚未运行时,进入应用的路径并不完全相同。掌握这条边界后,才能避免“前台收到两次、后台没走回调、点击通知后重复处理”等问题。([Firebase][2])
学习目标
- 能根据应用状态判断 notification、data 和混合消息的入口
- 能区分“系统展示”与“客户端收到回调”两条路径
- 能设计一次业务事件只处理一次的消息流程
三种应用状态下的处理路径
对于 Android FCM,前台和后台的关键差异首先出现在 notification 消息上:前台时消息进入 onMessageReceived,后台时 notification 通常由系统通知栏展示。data 消息则由客户端代码处理;notification + data 在后台时仍以“系统展示通知、点击后把 data 带入启动 Activity”为主要路径。([Firebase][2])
“未启动”不要简单理解为“永远收不到消息”。进程是否正在运行、应用是否被用户强制停止、设备当前是否允许相关后台活动,都会影响最终表现。因此业务设计应围绕可验证的入口处理,而不是假设某个回调在所有状态下都必然执行。
先把消息入口统一成业务事件
一个实用做法是:不管消息来自 onMessageReceived 还是通知点击后的 Activity,都转换成同一种业务事件,再由业务层判断是否已经处理。
package com.example.push
import android.content.Intent
import android.os.Bundle
import android.util.Log
import androidx.appcompat.app.AppCompatActivity
import com.google.firebase.messaging.RemoteMessage
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
handlePushIntent(intent)
}
override fun onNewIntent(intent: Intent) {
super.onNewIntent(intent)
setIntent(intent)
handlePushIntent(intent)
}
private fun handlePushIntent(intent: Intent) {
val orderId = intent.extras?.getString("orderId") ?: return
val event = intent.extras?.getString("event") ?: return
// 入口统一后,再交给业务层做幂等处理,而不是在 Activity 中直接改状态。
Log.d("FCM", "tap event=$event, orderId=$orderId")
}
}
class AppMessagingService : com.google.firebase.messaging.FirebaseMessagingService() {
override fun onMessageReceived(message: RemoteMessage) {
val event = message.data["event"] ?: return
val orderId = message.data["orderId"] ?: return
Log.d("FCM", "received event=$event, orderId=$orderId")
}
}预期结果
前台收到 data 消息时:
FCM: received event=order_shipped, orderId=<ID>
后台收到 notification + data,用户点击通知后进入 Activity 时:
FCM: tap event=order_shipped, orderId=<ID>这里展示的是两条合法入口,不表示同一条消息一定同时打印两次。后台 notification + data 的 data 处理点通常发生在用户点击通知启动 Activity 时。([Firebase][2])
为什么容易出现重复业务行为
最常见的问题是把“收到消息”和“用户点击通知”都当成一次完整业务执行。例如前台收到消息时更新订单,用户稍后又点击同一通知,再次触发订单刷新,于是埋点、跳转或状态变更重复执行。
解决方式不是简单删除其中一个入口,而是定义明确的职责:消息接收负责接收和解析,通知点击负责导航与上下文恢复,真正改变业务状态的操作放在幂等的业务层。可以使用服务端事件 ID 或业务对象版本作为去重依据。
验证不同状态
实际联调时至少分别验证前台、后台和进程未运行三种状态,并记录“发送的 payload、进入的代码入口、最终用户行为”。不要只验证通知栏是否出现,因为“通知显示成功”不等于“业务代码执行成功”。
例如,发送一条只含 data 的消息,再发送一条 notification + data 消息,分别观察 onMessageReceived、通知栏和点击 Intent 中的数据。FCM 官方文档明确给出了前台、后台下这几类消息的处理差异。([Firebase][2])
最终要建立的是一条稳定的业务链:FCM 负责投递,系统或 FirebaseMessagingService 负责进入应用,业务层负责幂等处理,Activity 负责通知点击后的导航与上下文恢复。