Flutter中flutter_local_notifications的zonedSchedule打包APK后失效 调试正常

调试模式功能正常、release版无报错无崩溃但定时通知失效，是flutter_local_notifications集成时的高频问题，核心原因是调试版与release版的编译规则、系统权限默认值存在差异，具体可按以下顺序排查修复：

1. 混淆与资源裁剪导致组件丢失 #

调试模式默认不会开启代码混淆和资源裁剪，release版编译时会通过R8/ProGuard静态扫描移除未被直接引用的代码，很容易把插件依赖的广播接收器、后台服务、时区数据库文件当成无用资源删除。

• 确认android/app/build.gradle中release构建的minifyEnabled、shrinkResources配置，如果开启了混淆，必须补充keep规则，完整保留flutter_local_notifications、timezone插件对应的所有类、广播组件、服务组件，以及内置的时区数据库资源，防止编译阶段被裁剪。
• 被裁剪的组件不会触发Dart层的异常，系统只是找不到对应的广播接收者唤起通知，因此全程不会有报错日志。

2. 精确闹钟权限缺失 #

从Android 12（API 31）开始，应用要设置可触发的精确定时闹钟，必须在AndroidManifest.xml中静态声明对应权限（SCHEDULE_EXACT_ALARM/USE_EXACT_ALARM），否则release版应用会被系统默认收回该权限，根本无法通过AlarmManager注册定时任务。

• 调试签名的应用默认会被系统授予精确闹钟权限，因此功能表现正常；release签名应用没有这个默认特权，权限缺失时系统会静默拒绝注册定时任务，不会抛出可被Dart层捕获的异常。
• 检查权限声明完整性，同时在调用zonedSchedule前增加权限校验，若权限未授予需引导用户前往系统设置开启。

3. 定制ROM的后台唤起拦截 #

国内厂商定制系统对release版应用的后台唤起、自启动有默认拦截规则，debug签名应用通常会被系统豁免这类拦截。

• 应用被拦截后，即使定时任务注册成功，应用在后台时也会被系统直接杀死，队列中的定时任务会被清空，最终表现为通知到点不弹出。
• 可通过引导用户将应用加入电池优化白名单、允许后台自启动解决这个问题。

4. 时区计算偏移 #

release版编译时如果开启了资源裁剪，很容易把timezone插件内置的时区数据库当成无用资源删掉，导致tz.local获取的实际时区与预期不一致，最终计算出的TzDateTime时间与用户选定的通知时间存在较大偏移，自然无法在预期时间触发通知。

• 这类问题不会触发报错，只是最终计算的触发时间被设置成了远期或已过的时间点，静默失效。

注意：release模式下Dart层的print日志默认不会输出，不要依赖打印日志判断逻辑是否执行成功，需单独验证平台侧的定时任务注册结果。

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