Android Kotlin每日定时通知延迟问题及过点不触发需求实现

你的定时通知出现延迟的核心原因在于重复闹钟的API使用错误，以及系统电池优化策略的影响，以下是具体诊断和修复方案：

问题诊断 #

1. setRepeating API的不精确性：从Android 4.4（API 19）开始，AlarmManager.setRepeating()不再保证精确触发，系统会将多个闹钟批量调度以节省电量，这直接导致了10-40秒的延迟。
2. 重复调用闹钟API导致覆盖：你同时调用了setExact()和setRepeating()，后者会直接覆盖前者设置的精确闹钟，最终生效的是不精确的重复闹钟。
3. 未适配Doze模式：当设备进入Doze模式时，普通的setExact()会被延迟触发，直到设备退出Doze。

修复方案 #

1. 替换重复闹钟实现逻辑 #

放弃使用setRepeating()，改为每次触发闹钟后，手动设置下一天的精确闹钟。同时使用setExactAndAllowWhileIdle()替代setExact()，确保在Doze模式下也能精确触发。

2. 修复后的代码 #

定时调度函数修改：

private fun scheduleNotification(context: Context, hour: Int, minute: Int) {
    val alarmManager = context.getSystemService(Context.ALARM_SERVICE) as AlarmManager
    val intent = Intent(context, AlarmReceiver::class.java).apply {
        // 携带定时参数，方便后续设置下一次闹钟
        putExtra("HOUR", hour)
        putExtra("MINUTE", minute)
    }
    // 使用唯一的requestCode，避免不同定时设置被覆盖
    val pendingIntent = PendingIntent.getBroadcast(
        context,
        "${hour}_$minute".hashCode(), // 用时间组合作为requestCode
        intent,
        PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE
    )

    val calendar = Calendar.getInstance().apply {
        timeInMillis = System.currentTimeMillis()
        set(Calendar.HOUR_OF_DAY, hour)
        set(Calendar.MINUTE, minute)
        set(Calendar.SECOND, 0)
        set(Calendar.MILLISECOND, 0)
        // 如果当前时间已过设定时间，设置为明天
        if (before(Calendar.getInstance())) {
            add(Calendar.DATE, 1)
        }
    }

    alarmManager.cancel(pendingIntent)

    // 根据系统版本选择合适的精确闹钟API
    val alarmType = AlarmManager.RTC_WAKEUP
    when {
        Build.VERSION.SDK_INT >= Build.VERSION_CODES.M -> {
            alarmManager.setExactAndAllowWhileIdle(alarmType, calendar.timeInMillis, pendingIntent)
        }
        Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT -> {
            alarmManager.setExact(alarmType, calendar.timeInMillis, pendingIntent)
        }
        else -> {
            alarmManager.set(alarmType, calendar.timeInMillis, pendingIntent)
        }
    }
}

private fun createNotificationChannel(context: Context) {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        val name = "Workout Reminder Channel"
        val descriptionText = "Channel for workout reminders"
        val importance = NotificationManager.IMPORTANCE_HIGH
        val channel = NotificationChannel("workout_reminder_channel", name, importance).apply {
            description = descriptionText
        }
        val notificationManager: NotificationManager =
            context.getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
        notificationManager.createNotificationChannel(channel)
    }
}

companion object {
    const val CHANNEL_ID = "workout_reminder_channel"
}

BroadcastReceiver修改（添加下一次闹钟调度）：

class AlarmReceiver : BroadcastReceiver() {
    override fun onReceive(context: Context, intent: Intent) {
        // 触发通知
        showNotification(context)

        // 获取之前设置的定时参数，调度下一天的闹钟
        val hour = intent.getIntExtra("HOUR", 0)
        val minute = intent.getIntExtra("MINUTE", 0)
        // 这里假设scheduleNotification是全局可调用的，可根据实际项目调整调用方式
        scheduleNotification(context, hour, minute)
    }

    private fun showNotification(context: Context) {
        val today = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            LocalDate.now().toString()
        } else {
            val cal = Calendar.getInstance()
            "${cal.get(Calendar.YEAR)}-${cal.get(Calendar.MONTH)+1}-${cal.get(Calendar.DAY_OF_MONTH)}"
        }

        val mainIntent = Intent(context, MainActivity::class.java).apply {
            flags = Intent.FLAG_ACTIVITY_NEW_TASK or Intent.FLAG_ACTIVITY_CLEAR_TASK
        }

        val pendingIntent = PendingIntent.getActivity(
            context,
            0,
            mainIntent,
            PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE
        )

        val notification = NotificationCompat.Builder(context, "workout_reminder_channel")
            .setSmallIcon(R.drawable.img_fitness1)
            .setContentTitle("Workout Reminder")
            .setContentText("It's time for your workout! Time : $today")
            .setPriority(NotificationCompat.PRIORITY_HIGH)
            .setContentIntent(pendingIntent)
            .setAutoCancel(true)
            .build()

        val notificationManager = context.getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
        notificationManager.notify(NOTIFICATION_ID, notification)
    }

    companion object {
        const val NOTIFICATION_ID = 1
    }
}

额外注意事项 #

• 电池优化白名单：引导用户将应用加入电池优化白名单，避免系统在后台限制闹钟触发。可通过Settings.ACTION_REQUEST_IGNORE_BATTERY_OPTIMIZATIONS跳转设置页面。
• Android 12+权限：需要申请POST_NOTIFICATIONS权限，否则通知无法正常显示。
• PendingIntent的requestCode：如果支持用户设置多个定时时间，必须使用唯一的requestCode，否则新的闹钟会覆盖旧的设置。

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