Android Studio中通知无法显示问题求助（附Kotlin代码）

1. 补全NotificationHelper并强制创建通知渠道 #

你的代码仅贴出了NotificationHelper的部分方法，核心的getNotification方法缺失，且Android 8.0（API 26）及以上必须创建通知渠道，否则通知完全无法显示。完整的NotificationHelper实现如下：

class NotificationHelper(private val ctx: Context) {
    private var notificationManager: NotificationManager? = null
    private val CHANNEL_ID = "app_core_notification"
    private val CHANNEL_NAME = "应用核心通知"

    init {
        createNotificationChannel()
    }

    private fun createNotificationChannel() {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            val channel = NotificationChannel(
                CHANNEL_ID,
                CHANNEL_NAME,
                NotificationManager.IMPORTANCE_DEFAULT
            ).apply {
                description = "应用常规通知渠道"
                enableVibration(true)
                setShowBadge(true)
            }
            getManager()?.createNotificationChannel(channel)
        }
    }

    fun getNotification(title: String, message: String, toneUri: String?): NotificationCompat.Builder {
        return NotificationCompat.Builder(ctx, CHANNEL_ID)
            .setSmallIcon(R.drawable.ic_notification) // 必须设置通知图标，否则通知不显示
            .setContentTitle(title)
            .setContentText(message)
            .setPriority(NotificationCompat.PRIORITY_DEFAULT)
            .setAutoCancel(true)
            .apply {
                toneUri?.let { setSound(Uri.parse(it)) }
            }
    }

    fun notify(id: Long, notification: NotificationCompat.Builder?) {
        if (shallNotify()) {
            notification?.let {
                getManager()?.notify(id.toInt(), it.build())
            }
        }
    }

    private fun getManager(): NotificationManager? {
        if (notificationManager == null) {
            notificationManager = ctx.getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
        }
        return notificationManager
    }

    // 检查此方法逻辑，确保返回true时才会发送通知
    private fun shallNotify(): Boolean {
        // 替换为你的实际判断逻辑，比如检查用户是否开启通知开关
        return true
    }
}

2. 确保广播接收器在Manifest中正确注册 #

在AndroidManifest.xml中添加以下注册代码，否则广播无法被系统触发：

<!-- NotifierReceiver -->
<receiver
    android:name=".NotifierReceiver"
    android:exported="false">
    <intent-filter>
        <action android:name="NOTIFICATION" /> <!-- 必须与AlarmHelper中的ACTION_BD_NOTIFICATION完全一致 -->
    </intent-filter>
</receiver>

<!-- BootReceiver -->
<receiver
    android:name=".BootReceiver"
    android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.BOOT_COMPLETED" />
        <action android:name="android.intent.action.QUICKBOOT_POWERON" /> <!-- 适配部分国产设备 -->
    </intent-filter>
</receiver>

<!-- 添加必要权限 -->
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
<!-- Android 13+ 必须申请通知权限 -->
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />

3. 修复AlarmManager在Doze模式下的触发限制 #

Android 6.0（API 23）及以上的Doze模式会限制setRepeating的触发频率，建议改用setExactAndAllowWhileIdle结合手动重复调度：

class AlarmHelper {
    private var alarmManager: AlarmManager? = null
    private val ACTION_BD_NOTIFICATION = "NOTIFICATION"

    fun setAlarm(context: Context, notificationFrequency: Long) {
        val notificationFrequencyMs = TimeUnit.MINUTES.toMillis(notificationFrequency)
        alarmManager = context.getSystemService(Context.ALARM_SERVICE) as AlarmManager

        val alarmIntent = Intent(context, NotifierReceiver::class.java)
        alarmIntent.action = ACTION_BD_NOTIFICATION
        val pendingAlarmIntent = PendingIntent.getBroadcast(
            context,
            0,
            alarmIntent,
            PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE
        )

        val triggerAtMillis = System.currentTimeMillis() + notificationFrequencyMs
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
            // 高版本使用精确闹钟，允许Doze模式下触发
            alarmManager?.setExactAndAllowWhileIdle(
                AlarmManager.RTC_WAKEUP,
                triggerAtMillis,
                pendingAlarmIntent
            )
        } else {
            alarmManager?.setRepeating(
                AlarmManager.RTC_WAKEUP,
                triggerAtMillis,
                notificationFrequencyMs,
                pendingAlarmIntent
            )
        }

        // 开机自启设置不变
        val receiver = ComponentName(context, BootReceiver::class.java)
        context.packageManager.setComponentEnabledSetting(
            receiver,
            PackageManager.COMPONENT_ENABLED_STATE_ENABLED,
            PackageManager.DONT_KILL_APP
        )
    }

    fun checkAlarm(context: Context): Boolean {
        val alarmIntent = Intent(context, NotifierReceiver::class.java)
        alarmIntent.action = ACTION_BD_NOTIFICATION
        return PendingIntent.getBroadcast(
            context, 0,
            alarmIntent,
            PendingIntent.FLAG_NO_CREATE or PendingIntent.FLAG_IMMUTABLE
        ) != null
    }
}

同时在NotifierReceiver的onReceive末尾添加重新调度逻辑，因为setExactAndAllowWhileIdle不会自动重复：

override fun onReceive(context: Context, intent: Intent) {
    // 原有的通知发送逻辑...

    // 重新设置下一次闹钟
    val prefs = context.getSharedPreferences(AppUtils.USERS_SHARED_PREF, AppUtils.PRIVATE_MODE)
    val notificationFrequency = prefs.getInt(AppUtils.NOTIFICATION_FREQUENCY_KEY, 60)
    val notificationsNewMessage = prefs.getBoolean("notifications_new_message", true)
    if (notificationsNewMessage) {
        AlarmHelper().setAlarm(context, notificationFrequency.toLong())
    }
}

4. 检查权限与系统设置 #

• Android 13（API 33）及以上需要动态申请POST_NOTIFICATIONS权限，在MainActivity中添加申请逻辑：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
    if (ContextCompat.checkSelfPermission(requireContext(), Manifest.permission.POST_NOTIFICATIONS) != PackageManager.PERMISSION_GRANTED) {
        requestPermissions(arrayOf(Manifest.permission.POST_NOTIFICATIONS), 1001)
    }
}

• 确保用户未在系统设置中关闭应用的通知权限。

5. 排查空值与异常 #

• 检查messageToShow是否为null，避免nBuilder空值导致崩溃，可在notify方法中增加空值判断（如上面修改后的NotificationHelper所示）。
• 查看Logcat中应用包名的报错信息，过滤NotificationManager关键词，定位是否有异常抛出。

内容的提问来源于stack exchange，提问作者DevMD