应用前台时停止弹出Firebase系统通知的实现方案咨询
可实现自主通知展示的落地解决方案
问题根因
FCM没有强制要求前台必须弹通知,你当前遇到的前台自动弹通知的行为,完全来自FCM对带notification字段消息的默认托管逻辑:
- 携带
notification字段的推送:无论应用处于前台、后台、进程被杀状态,系统都会自动生成通知展示,无需应用代码介入 - 仅携带
data字段的推送:无论应用处于任何状态,系统都不会自动生成通知,所有推送载荷会直接传递到应用代码层,展示逻辑完全可自主控制
方案选择
方案1:从推送源头调整消息结构(最优解)
- 所有对外发送的FCM推送统一移除消息体中的
notification字段,将需要展示的标题、正文、跳转链接等所有内容全部放到data字段中 - 这种方式从根源上避免了系统自动托管通知的逻辑,你可以在收到消息的任意节点,自主判断当前应用状态:前台时用应用内浮窗、角标提示、页面banner承接,后台时再手动构建系统通知展示
- 注意:这种发送方式需要你的应用后台服务可以稳定接收到被杀状态下的推送,适配各厂商的后台运行保活规则
方案2:无法调整推送端结构时,客户端层拦截自动通知逻辑
如果业务上没法修改推送端的消息构造,必须发送带notification字段的消息,可以在客户端做拦截控制:
- 升级FCM SDK到23.0.0及以上稳定版本(旧版本带notification的消息在前台不会触发应用层回调,无法拦截)
- 自定义继承
FirebaseMessagingService的服务类,重写handleNotificationReceived方法,这个方法就是系统自动生成通知的核心入口 - 通过全局Activity生命周期回调维护应用前后台状态标记,在方法内做分支判断:
- 前台状态:直接拦截流程,不调用父类的默认通知生成逻辑,转而用自定义的应用内提示承接消息
- 后台/最小化状态:放行流程,让系统自动生成通知展示
- 核心实现代码示例:
// 自定义FCM服务 class CustomFCMService : FirebaseMessagingService() { override fun handleNotificationReceived(message: RemoteMessage) { // 读取全局存储的应用前后台状态 val isForeground = AppForegroundTracker.isAppForeground if (isForeground) { // 前台场景:不触发系统通知,走自定义应用内提示逻辑 triggerInAppMessageTip(message.data) return } // 后台场景:走系统默认通知展示 super.handleNotificationReceived(message) } } // 全局前后台状态追踪类(在Application中初始化) object AppForegroundTracker { var isAppForeground = false }
常见落地注意事项
- 前台拦截的推送不要直接丢弃载荷,可以将消息内容暂存到应用本地消息中心,用户后续进入应用时可以查看历史接收的推送
- 适配国内厂商的FCM代理通道时,部分厂商控制台默认开启“前台自动弹通知”开关,需要单独关闭该开关,避免绕过应用层拦截逻辑
- 自主构建系统通知时,需要适配各Android版本的通知渠道权限要求,不要因为拦截逻辑导致后台状态下的通知无法正常展示
内容的提问来源于stack exchange,提问作者Muhammad Tameem Rafay
相关产品推荐
相关产品推荐

