原生移动开发 / 系统课时

排查通知不显示问题

排查通知不显示问题

通知没有出现时,不要先改业务代码或反复调用 notify()。Android 的通知展示同时受运行时权限、通知渠道、渠道重要级别、系统设置以及应用前后台状态影响。按固定顺序检查,才能把“代码没发出”和“系统拒绝展示”区分开。

学习目标

  • 能按权限、渠道、设置和运行状态建立通知排查顺序
  • 能通过 NotificationManager 检查通知权限与渠道状态
  • 能区分代码发送成功、系统接收成功和用户可见之间的差异

先确认通知请求确实执行

第一步只回答一个问题:产生通知的代码路径有没有真正执行。把业务日志放在 notify() 前面,不要只在点击通知后记录日志,因为点击事件没有发生时无法证明通知是否已经提交。

kotlin
import android.app.NotificationChannel
import android.app.NotificationManager
import android.content.Context
import android.os.Build
import android.util.Log

fun postTestNotification(context: Context) {
    val channelId = "diagnostic"
    val manager = context.getSystemService(NotificationManager::class.java)

    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        manager.createNotificationChannel(
            NotificationChannel(channelId, "诊断通知", NotificationManager.IMPORTANCE_DEFAULT)
        )
    }

    val enabled = manager.areNotificationsEnabled()
    Log.d("NotificationDebug", "notificationsEnabled=$enabled")

    if (!enabled) return

    val notification = android.app.Notification.Builder(context, channelId)
        .setSmallIcon(android.R.drawable.ic_dialog_info)
        .setContentTitle("诊断通知")
        .setContentText("用于确认通知链路是否可见")
        .build()

    Log.d("NotificationDebug", "calling notify id=4001")
    manager.notify(4001, notification)
}

预期结果

text
当通知权限允许且函数执行成功时,日志至少能看到 notificationsEnabled=true 和 calling notify id=4001,并出现一条“诊断通知”。若 notificationsEnabled=false,说明系统层面已经禁止应用通知,继续修改通知文本不会解决问题。

上面的检查只能证明应用当前被系统允许发送通知,不能保证某个具体渠道一定可见。Android 8.0 及以上版本,通知必须归属于具体渠道,而用户可以单独关闭某个渠道。

检查通知权限和渠道状态

对于 Android 13 及以上,通知还受到 POST_NOTIFICATIONS 运行时权限控制。即使代码成功调用 notify(),权限没有获得时仍可能看不到通知。排查时应把“应用通知总开关”和“具体渠道设置”分开检查。

可以在调试页面打印渠道的重要级别和是否被阻止。渠道状态是用户或系统设置的一部分,应用创建过同一个渠道后,不能依靠再次调用 createNotificationChannel() 把用户手动调低的重要级别强行恢复。

kotlin
import android.app.NotificationManager
import android.content.Context
import android.os.Build
import android.util.Log

fun inspectNotificationChannel(context: Context) {
    val manager = context.getSystemService(NotificationManager::class.java)
    val channelId = "diagnostic"

    Log.d("NotificationDebug", "notificationsEnabled=${manager.areNotificationsEnabled()}")

    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        val channel = manager.getNotificationChannel(channelId)
        if (channel == null) {
            Log.d("NotificationDebug", "channelMissing=$channelId")
            return
        }

        Log.d("NotificationDebug", "importance=${channel.importance}")
        Log.d("NotificationDebug", "blocked=${channel.importance == NotificationManager.IMPORTANCE_NONE}")
    }
}

预期结果

text
正常存在的渠道会输出具体 importance;如果渠道不存在,会输出 channelMissing=diagnostic;如果渠道 importance 为 IMPORTANCE_NONE,通常表示该渠道已被用户关闭,此时需要引导用户进入系统通知设置,而不是重新创建同名渠道。

把“权限问题”和“展示问题”分层定位

建议按以下顺序排查:先看应用通知是否开启,再看目标渠道是否存在且未被关闭,然后确认重要级别是否符合预期,最后检查设备的勿扰模式、锁屏通知策略、省电限制以及厂商系统设置。

通知未显示的分层排查流程

应用前后台状态也值得单独确认。前台时,通知可能表现为状态栏或通知区域中的提示;具体展示方式还会受到通知配置和系统策略影响。不要仅凭“当前页面没有弹出横幅”就认定 notify() 失败,应该先查看通知栏和系统通知历史等可用入口。

常见根因与修复方向

现象 优先检查 常见处理
所有通知都没有 应用通知总开关、运行时权限 检查 areNotificationsEnabled(),确认 Android 13+ 权限状态
只有某类通知没有 对应 NotificationChannel 检查渠道是否存在、是否被关闭、重要级别是否正确
代码日志有调用但看不到 系统设置、渠道、设备状态 先验证渠道,再检查设备通知策略
重新安装测试仍异常 渠道配置与系统状态 清理测试环境后重新验证,注意用户设置不会由业务代码随意覆盖
前台可见、后台表现不同 应用状态与系统展示策略 分别测试前台、后台、锁屏场景,不要只验证单一状态

测试修复后,应再次使用固定的诊断通知 ID 发送一条明确可识别的测试通知。这样可以避免旧通知、历史渠道和业务逻辑同时干扰判断。真正完成排查的标志,不是“代码没有异常”,而是能够明确指出通知在哪一层被阻止,并通过同一测试路径验证修复已经生效。

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

目录与阅读设置

阅读设置

17

记录一个想法

排查通知不显示问题

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

登录哪都通