Notifee库在Android设备重启后本地通知失效问题解析

问题背景

在使用Notifee库进行Android本地通知开发时，开发者可能会遇到一个棘手问题：当设备重启后，之前设置的定时通知无法正常触发。这个问题在Android 13/14系统上尤为明显，影响包括三星、一加和小米等多个品牌设备。

核心问题表现

通过代码分析，开发者通常会使用如下方式创建定时通知：

const trigger: TimestampTrigger = {
  type: TriggerType.TIMESTAMP,
  alarmManager: { type: AlarmType.SET_EXACT_AND_ALLOW_WHILE_IDLE },
  timestamp,
};

const notifeeNotification: NotifeeNotification = {
  title,
  body,
  android: {
    channelId: androidChannelId,
    importance: AndroidImportance.HIGH,
  },
};

await notifee.createTriggerNotification(notifeeNotification, trigger);

尽管代码看起来正确，但在设备重启后，如果不手动打开应用，预定的通知就不会触发。从日志中可以看到系统确实接收到了重启事件并尝试重新调度通知，但实际通知并未显示。

问题根源

经过深入排查，发现问题的根本原因是缺少RECEIVE_BOOT_COMPLETED权限。这个权限允许应用在设备启动完成后接收广播，对于需要持久化定时通知的应用至关重要。

有趣的是，Notifee库的核心模块确实已经包含了这个权限声明。但在实际构建发布版本时，该权限可能没有被正确合并到最终的应用清单中。这可能是由于Android构建系统的权限合并机制或特定设备厂商的定制系统导致的。

解决方案

开发者需要在应用的主AndroidManifest.xml文件中显式添加以下权限声明：

<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />

技术原理

1. Android启动广播机制：当设备完成启动时，系统会发送BOOT_COMPLETED广播。应用需要注册接收这个广播才能执行重启后的初始化操作。

2. 通知持久化：定时通知通常依赖于系统的AlarmManager服务。设备重启后，所有未触发的闹钟都会被清除，需要应用重新注册。

3. 权限合并机制：Android构建系统会将库模块和应用模块的清单文件合并。但在某些情况下，来自库模块的权限可能不会被正确包含。

最佳实践建议

1. 即使库模块声明了权限，也建议在主应用中显式声明关键权限
2. 对于关键功能相关的权限，应在应用描述中说明其用途
3. 定期检查合并后的清单文件，确认所有必要权限都已包含
4. 在不同厂商设备上进行充分测试，特别是针对重启场景

总结

Notifee库虽然功能强大，但在Android设备重启后通知失效的问题需要开发者特别注意。通过显式添加RECEIVE_BOOT_COMPLETED权限，可以确保定时通知在各种设备上都能可靠工作。这个问题也提醒我们，在Android开发中，即使是库提供的功能，也需要对底层机制有充分理解，才能确保应用在所有场景下都能正常运行。