Flutter：如何实现自定义周期本地通知？解决仅首次生效问题

核心问题 #

你当前的实现只配置了单次通知调度，未设置重复规则，且时间处理逻辑仅覆盖首次/次日触发，这是通知仅生效一次、修改系统时间后无响应的根本原因，不需要额外添加任务管理器。

具体修复步骤 #

1. 添加重复周期配置
   在zonedSchedule调用中加入repeatInterval参数，根据用户选择的周期传入对应时长：

   • 每日重复：repeatInterval: const Duration(days: 1)
   • 每周重复：repeatInterval: const Duration(days: 7)
   • 每月重复：需单独处理（因不同月份天数不同，不能直接用固定Duration，需计算下月同一日期）

2. 修正时间触发逻辑
   当前_nextInstanceOf8PM仅处理了首次触发时间，未考虑重复周期下的后续触发，且系统时间修改后无法重新计算。调整逻辑需确保：

   • 首次触发时间不早于当前时间
   • 针对不同周期计算正确的下一次触发时间（比如每月重复时，处理月末日期的溢出情况，如1月31日的下月是2月最后一天）

3. 系统时间变更适配
   监听系统时间变化，在时间变更时取消原有通知并重新调度，确保触发时间与新系统时间同步。

修改后的代码示例 #

// 新增周期参数：daily/weekly/monthly
static void showScheduledNotification(int id, String title, String body,
    String startDate, String startTime, String repeatCycle) async {
  NotificationDetails details = const NotificationDetails(
    android: AndroidNotificationDetails(
      'id_3',
      '日程提醒',
      channelDescription: '自定义周期日程提醒通道',
      importance: Importance.max,
      priority: Priority.high,
      playSound: true,
      enableVibration: true,
    ),
  );

  tz.initializeTimeZones();
  final String currentTimeZone = await FlutterTimezone.getLocalTimezone();
  tz.setLocalLocation(tz.getLocation(currentTimeZone));
  
  // 根据周期获取重复间隔和初始触发时间
  Duration? repeatInterval;
  tz.TZDateTime scheduledDate = _getNextTriggerTime(startDate, startTime, repeatCycle);
  
  switch(repeatCycle) {
    case 'daily':
      repeatInterval = const Duration(days: 1);
      break;
    case 'weekly':
      repeatInterval = const Duration(days: 7);
      break;
    case 'monthly':
      // 每月重复不使用固定repeatInterval，需每次计算下一月日期
      repeatInterval = null;
      break;
  }

  await flutterLocalNotificationsPlugin.zonedSchedule(
    id,
    title,
    body,
    scheduledDate,
    details,
    uiLocalNotificationDateInterpretation: UILocalNotificationDateInterpretation.absoluteTime,
    repeatInterval: repeatInterval,
    // 每月重复需设置allowWhileIdle，避免Doze模式下不触发
    androidAllowWhileIdle: true,
  );

  // 若为每月重复，需在每次触发后重新调度下一月（可通过监听通知触发回调实现）
}

static tz.TZDateTime _getNextTriggerTime(String startDate, String startTime, String repeatCycle) {
  var parsedDate = parseDateString(startDate);
  int hour = int.parse(startTime.split(':')[0]);
  int min = int.parse(startTime.split(':')[1]);

  var scheduledDate = tz.TZDateTime(
    tz.local,
    parsedDate.year,
    parsedDate.month,
    parsedDate.day,
    hour,
    min,
  );

  var now = tz.TZDateTime.now(tz.local);

  // 初始时间已过，根据周期计算下一次
  if (now.isAfter(scheduledDate)) {
    switch(repeatCycle) {
      case 'daily':
        scheduledDate = scheduledDate.add(const Duration(days: 1));
        break;
      case 'weekly':
        scheduledDate = scheduledDate.add(const Duration(days: 7));
        break;
      case 'monthly':
        // 计算下月同一日期，处理月末溢出
        scheduledDate = _addOneMonth(scheduledDate);
        break;
    }
  }

  return scheduledDate;
}

// 辅助函数：计算下月同一日期（处理月末情况）
static tz.TZDateTime _addOneMonth(tz.TZDateTime date) {
  int year = date.year;
  int month = date.month;
  int day = date.day;

  // 下月月份和年份
  int nextMonth = month + 1;
  int nextYear = year;
  if (nextMonth > 12) {
    nextMonth = 1;
    nextYear += 1;
  }

  // 获取下月的最大天数
  int maxDaysInNextMonth = DateTime(nextYear, nextMonth + 1, 0).day;
  // 若当前日期超过下月最大天数，则取下月最后一天
  int adjustedDay = day > maxDaysInNextMonth ? maxDaysInNextMonth : day;

  return tz.TZDateTime(tz.local, nextYear, nextMonth, adjustedDay, date.hour, date.minute);
}

static DateTime parseDateString(String dateString) {
  DateFormat format = DateFormat('MMM dd, yyyy');
  return format.parse(dateString);
}

额外注意事项 #

• Android端需开启androidAllowWhileIdle: true，确保设备在Doze模式下仍能触发通知
• 每月重复无法直接用repeatInterval，需在每次通知触发后，通过didReceiveNotificationResponse回调重新调度下一月的通知
• 修改系统时间后，若使用固定repeatInterval，插件可能无法自动更新触发时间，需监听时间变化事件，取消原有通知并重新调度

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