原生移动开发 / 系统课时
定位收到消息却没有通知
定位收到消息却没有通知
消息已经到达应用,却看不到通知时,不要先怀疑推送服务。先确认消息属于哪种类型,再按通知权限、NotificationChannel、前后台处理顺序排查,通常可以快速缩小故障范围。
学习目标
- 区分通知消息与数据消息的处理差异
- 按权限、Channel、前后台状态定位通知未展示
- 用代码和 Logcat 验证消息是否真正进入通知展示路径
先判断消息走哪条路径
Android 推送到达后,并不意味着一定会自动出现系统通知。通知消息可能由系统或 SDK 在特定条件下直接展示,数据消息则通常需要应用代码接收并决定是否调用 NotificationManager.notify()。
排查时先记录三个事实:消息到底到没到、应用收到后进入了哪条分支、最终是否执行了通知发布。只看服务端“发送成功”不能证明设备已经展示通知。

检查通知权限与渠道
Android 13 及以上,应用需要先获得 POST_NOTIFICATIONS 运行时通知权限。即使权限已经授予,具体通知渠道也可能被用户单独关闭,因此“应用通知总开关开启”与“目标 Channel 可用”必须分别验证。
应用创建通知渠道时,应使用稳定的 channel ID。不要在每次发送通知时动态生成新 ID,否则会让排查和用户设置变得混乱。
import android.app.NotificationChannel;
import android.app.NotificationManager;
import android.content.Context;
import android.os.Build;
public final class NotificationChannels {
public static final String ID = "default";
private NotificationChannels() {}
public static void ensureCreated(Context context) {
if (Build.VERSION.SDK_INT < Build.VERSION_CODES.O) {
return;
}
NotificationChannel channel = new NotificationChannel(
ID,
"默认通知",
NotificationManager.IMPORTANCE_DEFAULT
);
NotificationManager manager =
context.getSystemService(NotificationManager.class);
if (manager != null) {
manager.createNotificationChannel(channel);
}
}
}预期结果
Android 8.0 及以上执行后,可通过系统通知设置看到 ID 为 default 的通知渠道;低于 Android 8.0 时不会创建 Channel。同时检查应用通知总开关、目标 Channel 的开关及重要级别。若 Channel 曾被用户关闭或降为较低级别,重新调用 createNotificationChannel() 不会替用户恢复已经存在 Channel 的用户设置。
区分前台与后台处理
很多“后台收得到、前台没有通知”的问题,其实是消息处理逻辑不同。前台回调可能把消息交给应用代码处理,而后台时则可能由系统或推送 SDK 采用另一条路径。因此不要只在前台打开页面测试。
数据消息常见的核心路径是:消息回调 → 业务判断 → 构建 Notification → 指定正确的 Channel → 调用 notify()。任意一步没有执行,都可能表现为“消息到了但没通知”。
排查时建议在消息回调和 notify() 前分别打一条日志,日志内容至少包含消息类型、业务 ID 与通知 ID,方便把“收到消息”和“展示通知”两个事实区分开。
adb logcat -v time | grep -E "Push|Notification|notify|<ID>"预期输出
<实际时间> I/Push: message received type=data id=<ID>
<实际时间> I/Push: notify posted id=<ID>实际日志标签和时间会因应用实现不同而变化;重点是确认“收到消息”和“发布通知”是否都出现。
用最短路径锁定根因
当消息明确已经到达时,可以按这个顺序继续缩小范围:
- 确认通知权限是否允许。
- 确认代码使用的 Channel ID 与已创建的 Channel ID 完全一致。
- 确认目标 Channel 没被用户关闭,重要级别满足当前产品需求。
- 确认前台、后台对应的消息处理分支是否不同。
- 确认最终确实执行了
NotificationManager.notify()。 - 检查设备系统是否对应用通知、锁屏展示或勿扰模式进行了限制。
把故障定位到具体阶段后,再修复对应配置或代码。若日志证明回调已执行但 notify() 没有出现,重点检查应用分支;若 notify() 已执行却不可见,则优先检查权限、Channel 和系统通知设置。