基于特定日期调度周期性本地通知 安卓11+通知偶发不显示问题

根因梳理 #

• WorkManager重复入队：当前每次进入MainActivity都会新增一个15分钟周期的任务，没有去重逻辑，大量重复任务会触发系统后台限流，甚至被加入耗电应用黑名单。
• 异步任务未等待就返回结果：Worker的doWork()方法中调用的数据库读取是异步操作，还没等到回调执行就返回了Result.success()，WorkManager会直接回收任务进程，后续的setAlarm()逻辑根本无法执行。
• PendingIntent标志位不兼容：Android 12及以上要求必须显式指定FLAG_IMMUTABLE或FLAG_MUTABLE，仅使用FLAG_ONE_SHOT会导致PendingIntent创建失败，闹钟无法正常调度。
• 闹钟调用方式不符合系统要求：Android 11+对后台闹钟限制严格，使用普通的set()方法在低电模式、后台待机场景会被系统延迟触发，且未申请精准闹钟权限的情况下，定时任务无法准时唤醒。
• 权限缺失：Android 13+要求动态申请POST_NOTIFICATIONS权限，未授权的情况下通知无法弹出；同时后台运行、电池优化限制会导致应用在未打开的状态下所有后台任务被禁止。
• 通知渠道缺失：Android 8.0及以上要求通知必须绑定合法的通知渠道，未创建渠道的通知会被系统直接拦截。

修复步骤 #

1. 调整Worker逻辑，等待异步操作完成 #

使用CountDownLatch阻塞等待数据库异步回调执行完成后再返回任务结果，避免逻辑被中断：

@NonNull
@Override
public Result doWork() {
    CountDownLatch latch = new CountDownLatch(1);
    final boolean[] hasPendingCollection = {false};
    
    checkTomorrowsCollection(getTomorrowDate(), new OnResultListener<Boolean>() {
        @Override
        public void onResult(Boolean result) {
            hasPendingCollection[0] = result;
            latch.countDown();
        }
    });
    
    try {
        // 最多等待10秒，避免长时间阻塞触发ANR
        latch.await(10, TimeUnit.SECONDS);
        if (hasPendingCollection[0]) {
            setAlarm();
        }
        return Result.success();
    } catch (InterruptedException e) {
        // 中断后重试任务
        return Result.retry();
    }
}

2. 修正WorkManager入队逻辑，避免重复任务 #

使用唯一周期任务API，避免每次启动应用都新建任务，同时将任务周期调整为24小时（仅需每日检查一次，减少后台耗电避免被系统限流）：

PeriodicWorkRequest collectionCheckerWorkRequest = new PeriodicWorkRequest
        .Builder(CollectionNotificationWorker.class, 24, TimeUnit.HOURS)
        .addTag(CollectionNotificationWorker.WORKER_TAG)
        .build();

WorkManager.getInstance(this)
        .enqueueUniquePeriodicWork(
                "UNIQUE_COLLECTION_CHECK_TASK",
                ExistingPeriodicWorkPolicy.KEEP, // 已有任务则保留，无需重复创建
                collectionCheckerWorkRequest
        );

3. 兼容PendingIntent标志位 #

针对高版本安卓系统调整标志位，避免PendingIntent创建失败：

int pendingFlag;
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
    pendingFlag = PendingIntent.FLAG_ONE_SHOT | PendingIntent.FLAG_IMMUTABLE;
} else {
    pendingFlag = PendingIntent.FLAG_ONE_SHOT;
}

PendingIntent pendingIntent = PendingIntent.getBroadcast(
        context,
        ALARM_REQUEST_CODE,
        intent,
        pendingFlag
);

4. 调整闹钟调度逻辑，适配系统限制 #

首先在AndroidManifest.xml中添加所需权限：

<!-- 精准闹钟调度权限 -->
<uses-permission android:name="android.permission.SCHEDULE_EXACT_ALARM" />
<!-- 通知发送权限 -->
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
<!-- 可选：申请忽略电池优化，后台场景更稳定 -->
<uses-permission android:name="android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS" />

然后修改setAlarm()方法，使用精准闹钟API，同时做权限校验：

private void setAlarm() {
    AlarmManager am = (AlarmManager) SharedLibrary.getApplicationContext()
            .getSystemService(Context.ALARM_SERVICE);
    Intent intent = new Intent(getApplicationContext(), AlarmBroadcast.class);
    
    // 此处插入上面调整后的PendingIntent创建逻辑
    
    long tomorrow10ClockTs = getTomorrow10ClockTimestamp(); // 自己实现获取次日10点时间戳的逻辑
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
        if (am.canScheduleExactAlarms()) {
            am.setExactAndAllowWhileIdle(AlarmManager.RTC_WAKEUP, tomorrow10ClockTs, pendingIntent);
        } else {
            // 引导用户跳转授权精准闹钟权限
            Intent permissionIntent = new Intent(Settings.ACTION_REQUEST_SCHEDULE_EXACT_ALARM);
            permissionIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
            context.startActivity(permissionIntent);
        }
    } else {
        am.setExactAndAllowWhileIdle(AlarmManager.RTC_WAKEUP, tomorrow10ClockTs, pendingIntent);
    }
}

5. 补全通知相关逻辑 #

• 应用启动时主动检查并动态申请POST_NOTIFICATIONS权限（Android 13+）
• 在发送通知前先创建合法的通知渠道（Android 8.0+）
• 可选：引导用户将应用加入系统电池优化白名单，减少后台限制

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