原生移动开发 / 系统课时

完成消息提醒综合链路

完成消息提醒综合链路

本课把定时任务、可靠后台执行、推送接收、通知展示和页面跳转串成一条可排查的链路。重点不是把组件堆在一起,而是明确每个环节的职责、失败点和验证位置。

学习目标

  • 能根据任务触发方式选择 AlarmManager、WorkManager、FCM 或厂商推送入口
  • 能设计从消息接收到通知展示、点击跳转的完整数据链路
  • 能按权限、进程、调度、推送、通知和页面六个环节定位故障

先把职责边界固定下来

综合链路中最容易出现的问题,是让一个组件承担了不属于它的职责。可以先按“谁负责触发、谁负责执行、谁负责唤醒、谁负责展示”拆开。

环节 典型组件 主要职责
用户设定的精确时间 AlarmManager 在需要的时间点触发入口
可延迟、需可靠执行的后台工作 WorkManager 持久化调度并执行可重试任务
服务端主动推送 FCM 或厂商推送 SDK 将消息送达设备
持续、用户可感知的工作 Foreground Service 在合规前提下持续执行
用户可见提醒 NotificationManager 创建、更新、取消通知
点击后的业务落点 Activity / Navigation 根据消息数据打开目标页面

FCM 在 Android 客户端通常通过 FirebaseMessagingService 处理消息;后台收到通知消息时,系统通常直接把通知放入系统通知栏,因此不能假设所有消息都会进入 onMessageReceived()。需要长时间处理的任务,也不应依赖短时的消息回调完成。 ([Firebase][1])

消息提醒综合链路

统一消息对象,避免入口各写一套

FCM、厂商推送、AlarmManager 回调和应用内事件的来源不同,但进入业务层后最好转换成同一种内部消息结构。例如统一保留消息 ID、标题、正文和业务跳转参数。这样通知层只处理一种输入,点击页面也不需要判断消息来自哪个推送平台。

kotlin
// 片段示例:依赖现有 Android App、Firebase 配置和业务 PushMessage 定义。
data class PushMessage(
    val messageId: String,
    val title: String,
    val body: String,
    val targetPath: String?
)

class AppPushMessageHandler(
    private val notificationManager: NotificationManager
) {
    fun handle(message: PushMessage) {
        val intent = Intent(notificationManager.getApplicationContext(), MainActivity::class.java).apply {
            putExtra("message_id", message.messageId)
            putExtra("target_path", message.targetPath)
            addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP or Intent.FLAG_ACTIVITY_SINGLE_TOP)
        }

        val pendingIntent = PendingIntent.getActivity(
            notificationManager.getApplicationContext(),
            message.messageId.hashCode(),
            intent,
            PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE
        )

        val notification = NotificationCompat.Builder(
            notificationManager.getApplicationContext(),
            "message"
        )
            .setSmallIcon(R.drawable.ic_notification)
            .setContentTitle(message.title)
            .setContentText(message.body)
            .setAutoCancel(true)
            .setContentIntent(pendingIntent)
            .build()

        notificationManager.notify(message.messageId.hashCode(), notification)
    }
}

预期结果

text
片段示例预期行为:收到统一 PushMessage 后生成一条通知;通知携带 message_id 与 target_path;用户点击后由系统启动或复用 MainActivity,并将这些数据放入 Intent extras。

这里的 NotificationManager、NotificationCompat.Builder、PendingIntent 和 MainActivity 属于应用已有上下文,因此代码是链路实现片段,不代表可单独创建工程运行。通知渠道、图标和 POST_NOTIFICATIONS 等基础条件必须先完成。

把触发入口分成三条路径

定时提醒、可靠后台任务和实时推送不要互相替代。需要接近用户指定时间的闹钟才考虑 AlarmManager;可以延迟、需要持久化和约束管理的后台工作更适合 WorkManager;服务端实时消息则进入 FCM 或厂商推送通道。

Android 12 及以上对精确闹钟有额外访问限制,使用精确闹钟前应检查对应能力;官方也建议只有确有时间精度要求时才使用精确闹钟,因为它的资源成本更高。 ([Android Developers][2])

例如,闹钟到点后只负责产生一个“提醒任务”,真正较重的同步、数据库写入或网络工作交给合适的后台执行机制。这样即使业务处理耗时,也不会把所有压力集中到 BroadcastReceiver 或推送回调里。

Android 13+ 要单独检查通知权限

Android 13(API 33)增加了 POST_NOTIFICATIONS 运行时权限。即使 FCM 消息已经到达设备,没有通知权限也不能正常显示普通通知,因此“推送送达”和“用户看到通知”必须作为两个独立检查点。 ([Android Developers][3])

排查时可以依次确认:应用是否声明权限、当前用户是否允许通知、目标通知渠道是否存在并开启,以及代码是否真的调用了 notify()。不要把“FCM 控制台显示发送成功”直接等同于“Android 通知栏一定出现”。

厂商推送放在适配层,不让业务绑死 SDK

不同厂商推送的注册、回调和后台策略可能不同,因此业务层不要直接依赖某个厂商 SDK 的具体类。可以定义统一入口,例如 PushProvider,由 FCM 和各厂商实现各自的接收与注册逻辑,再把结果转换成统一的 PushMessage。

kotlin
// 片段示例:仅展示业务层抽象,不依赖任何厂商 SDK。
interface PushProvider {
    fun start()
    fun stop()
    fun setMessageListener(listener: (PushMessage) -> Unit)
}

class PushRouter(
    private val providers: List<PushProvider>,
    private val messageHandler: (PushMessage) -> Unit
) {
    fun start() {
        providers.forEach { provider ->
            provider.setMessageListener(messageHandler)
            provider.start()
        }
    }
}

预期结果

text
片段示例预期行为:FCM 与厂商推送实现都向 PushRouter 提供统一 PushMessage;业务通知代码只依赖 PushMessage,不直接判断具体推送平台。

这种结构还有一个实际好处:某一厂商通道异常时,可以单独记录 provider、messageId 和处理阶段,而不会把整个业务链路变成无法定位的大回调。

点击跳转必须做幂等处理

通知展示完成并不意味着链路结束。用户可能在冷启动、已有 Activity、重复点击或进程重新创建后点击同一条消息,因此跳转参数应该能够重复处理,并且业务页面打开后再次读取 message_id 时不会重复执行关键操作。

Intent 中建议只传递轻量、稳定的业务标识,例如消息 ID、对象 ID 和目标路径;真正的数据可以在目标页面根据 ID 从本地缓存或服务端重新获取。这样可以避免通知点击时携带过大的业务状态。

综合排障顺序

出现“消息没有提醒”时,不要直接从通知 UI 开始改代码。按照入口向终点逐段验证,能够最快缩小范围。

  1. 先确认触发源确实发生,例如 AlarmManager 是否注册成功,WorkManager 是否进入预期状态,服务端是否获得有效推送注册令牌。
  2. 再确认推送或调度入口是否被系统接收,特别注意 FCM 消息类型与应用前后台状态;后台通知消息未必会调用 onMessageReceived()。 ([Firebase][4])
  3. 再检查业务处理是否完成,包括进程是否被回收、短时回调是否执行过久、是否把长任务正确转交给 WorkManager。
  4. 最后检查通知权限、通知渠道、通知 ID、PendingIntent 以及目标 Activity 的参数解析。

实际日志中至少关联一个稳定的 messageId。把“收到消息”“完成业务处理”“调用通知 API”“用户点击通知”分别记成独立事件,才能判断问题究竟发生在送达、处理、展示还是跳转阶段。

完成这条综合链路后,真正可维护的标准不是“某台手机上能弹出通知”,而是每个入口都有明确职责、每个阶段都有可验证状态,并且消息 ID 能贯穿接收、处理、展示和跳转。这样面对后台限制、通知权限变化或厂商差异时,才能沿着同一条链路快速定位故障。

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

目录与阅读设置

阅读设置

17

记录一个想法

完成消息提醒综合链路

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

登录哪都通