Flutter应用推送通知点击不触发问题排查求助

核心问题定位 #

你当前代码的关键bug是：点击按钮时每次都新建了一个NotificationService实例，但初始化的是另一个独立实例，导致调用showNotification时使用的是未完成初始化的插件实例，自然无法正常触发通知。

排查与修复步骤 #

1. 全局复用NotificationService实例 #

必须保证初始化和调用通知的是同一个实例，有两种实现方式：

方式一：通过构造函数传递实例（修改main.dart）

import 'package:flutter/material.dart';
import 'notification_service.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  // 初始化通知服务并保存实例
  final notificationService = NotificationService();
  await notificationService.init();

  runApp(MyApp(notificationService: notificationService));
}

class MyApp extends StatelessWidget {
  final NotificationService notificationService;

  const MyApp({super.key, required this.notificationService});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Notification App'),
        ),
        body: Center(
          child: ElevatedButton(
            onPressed: () async {
              // 使用全局初始化的实例调用通知
              await notificationService.showNotification();
            },
            child: const Text('Show Notification'),
          ),
        ),
      ),
    );
  }
}

方式二：使用单例模式（修改notification_service.dart）

import 'package:flutter_local_notifications/flutter_local_notifications.dart';
import 'package:permission_handler/permission_handler.dart';

class NotificationService {
  final FlutterLocalNotificationsPlugin _flutterLocalNotificationsPlugin =
      FlutterLocalNotificationsPlugin();

  // 单例模式确保全局唯一实例
  static final NotificationService _instance = NotificationService._internal();
  factory NotificationService() => _instance;
  NotificationService._internal();

  Future<void> init() async {
    const initializationSettingsAndroid = AndroidInitializationSettings('@mipmap/ic_launcher');
    const initializationSettingsIOS = IOSInitializationSettings();
    const initializationSettings = InitializationSettings(
      android: initializationSettingsAndroid,
      iOS: initializationSettingsIOS,
    );

    // 打印初始化结果，方便排查
    final initResult = await _flutterLocalNotificationsPlugin.initialize(
      initializationSettings,
      onSelectNotification: onSelectNotification,
    );
    print("插件初始化结果: $initResult");

    await _requestNotificationPermission();
  }

  Future<void> _requestNotificationPermission() async {
    final status = await Permission.notification.request();
    print("通知权限状态: $status");
    if (!status.isGranted) {
      print("通知权限未授予，请引导用户在系统设置中开启");
    }
  }

  Future<void> showNotification() async {
    print("尝试显示通知...");

    const androidChannel = AndroidNotificationDetails(
      'default_notification_channel', // 唯一渠道ID（Android 8.0+必填）
      '默认通知渠道',
      '用于展示应用通知内容',
      importance: Importance.high,
      priority: Priority.high,
      enableVibration: true,
      playSound: true,
    );
    const iosChannel = IOSNotificationDetails();
    const notificationDetails = NotificationDetails(
      android: androidChannel,
      iOS: iosChannel,
    );

    try {
      // 用时间戳做通知ID，避免重复通知被覆盖
      await _flutterLocalNotificationsPlugin.show(
        DateTime.now().millisecondsSinceEpoch,
        '测试通知标题',
        '这是一条测试通知内容',
        notificationDetails,
        payload: 'custom_payload',
      );
      print("通知显示成功");
    } catch (e) {
      print("通知显示失败: $e");
    }
  }

  Future<void> onSelectNotification(String? payload) async {
    print("通知被点击，payload: $payload");
    // 可添加点击通知后的跳转逻辑
  }
}

2. 平台额外配置验证 #

• Android端：
  • 检查应用系统设置中的通知权限是否开启
  • 确认对应通知渠道未被屏蔽（可在系统设置-应用通知中查看）
• iOS端：
  • 必须在Info.plist中添加权限描述：

    <key>NSNotificationUsageDescription</key>
    <string>需要通知权限向您发送重要提醒</string>
    

3. 测试注意事项 #

• 部分设备在应用前台焦点状态下，通知可能不会弹出到状态栏，可切换到后台测试
• 查看控制台打印的权限状态、初始化结果、通知调用日志，快速定位失败环节

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