Flutter local notification断网触发时报空指针错误无法显示

问题背景 #

• 使用flutter_local_notifications包实现网络断开时自动弹出本地通知的功能
• 网络连接状态检测逻辑运行正常，但通知无法正常展示
• 抛出安卓原生侧报错：Attempt to invoke virtual method 'int java.lang.Integer.intValue()' on a null object reference
• 初步怀疑问题出在main.dart第60行的setState逻辑位置

核心报错原因 #

该空指针报错本质是安卓原生侧调用通知相关方法时，需要转为基础int类型的Integer对象为null，对应Flutter侧的常见诱因包括：必填整型配置参数未显式传值、通知插件未完成初始化就被调用、逻辑时序冲突。

排查方向 #

• 检查通知插件初始化逻辑：核对安卓端初始化配置、通知渠道配置中的必填整型参数（通知重要性、优先级、默认通知ID）是否存在传null、未赋值的情况；确认初始化方法是否加了await，是否存在初始化未完成就提前调用show()方法的时序问题
• 检查setState触发逻辑：确认网络状态回调触发setState的时机，是否早于通知插件初始化完成，导致调用了未完成初始化的通知实例
• 检查通知展示方法的入参：核对调用show()方法时传入的通知ID、安卓专属配置中的整型字段是否存在可空值、未传值的情况

修复方案 #

1. 补全通知初始化的必填参数，保证调用时序正确
   • 全局增加初始化状态标记：bool isNotificationReady = false;
   • 初始化时必须加await等待执行完成，安卓配置中显式传入所有必填参数，不要依赖默认值：

     class NotificationApi {
       static Future init() async {
         const AndroidInitializationSettings androidInit = AndroidInitializationSettings('@mipmap/ic_launcher');
         const InitializationSettings initSettings = InitializationSettings(android: androidInit);
         await FlutterLocalNotificationsPlugin().initialize(initSettings);
         // 初始化完成后再更新状态标记
         isNotificationReady = true;
       }
     }
     

   • App启动后优先await执行NotificationApi.init()，不要和网络状态监听同时初始化，避免时序冲突
2. 修复setState处的调用逻辑
   • 网络状态断开触发setState、调用通知前，先判断初始化状态，未完成则等待初始化结束再调用，不要直接触发通知：

     // 网络断开回调逻辑
     if (!isNotificationReady) {
       await NotificationApi.init();
     }
     NotificationApi.showDisconnectNotif();
     // 通知触发完成后再执行setState更新UI逻辑
     setState(() {
       // 原有页面状态更新逻辑
     });
     

3. 补全通知展示方法的必填参数
   • 调用show()方法时，通知ID必须传入固定非空int值，安卓通知详情配置中必须显式指定importance、priority参数，禁止留空：

     static Future showDisconnectNotif() async {
       const AndroidNotificationDetails androidDetails = AndroidNotificationDetails(
         'network_channel',
         '网络状态通知',
         channelDescription: '网络连接状态提醒',
         importance: Importance.high, // 必须显式传入，缺省会导致底层拿null调用intValue触发报错
         priority: Priority.high, // 必须显式传入
       );
       const NotificationDetails details = NotificationDetails(android: androidDetails);
       await FlutterLocalNotificationsPlugin().show(
         1, // 通知ID必须传非空int值
         '网络已断开',
         '当前设备未连接到网络',
         details,
       );
     }
     

内容的提问来源于stack exchange，提问作者Selen Sönmez