iOS后台/锁屏状态下本地通知触发时执行代码的方案咨询

我完全懂你遇到的这个棘手问题——当闹钟触发时，App大概率处于后台、被系统杀死甚至设备锁屏的状态，这时候主App的代码根本跑不起来，只能被动展示带附件和声音的通知，没法自动调度下一条闹钟。下面是几个经过实际验证的解决方案，按可靠性优先级排序：

1. 优先使用Notification Service Extension（最可靠） #

这是苹果专门为通知展示前的后台自定义操作设计的机制，哪怕主App已经被杀死，系统也会唤起这个独立的扩展运行（大概有30秒左右的执行窗口，足够完成设置下一条通知的操作）。

具体步骤： #

• 在Xcode中给项目添加新的Notification Service Extension target（注意不要勾选“Include UI Extension”）
• 打开扩展的NotificationService.swift文件，在didReceive(_:withContentHandler:)方法里编写创建并调度下一条本地通知的逻辑
• 因为扩展和主App属于独立沙盒，需要配置App Groups来共享闹钟配置数据（比如下一次闹钟的时间、内容）：
  1. 在开发者后台给你的App ID启用App Groups，创建一个组ID（例如group.com.yourcompany.yourapp）
  2. 在主App和Extension的target设置里，开启App Groups并选择刚才创建的组
  3. 使用UserDefaults(suiteName: "你的组ID")来读写共享数据

代码示例（NotificationService.swift）： #

import UserNotifications

class NotificationService: UNNotificationServiceExtension {

    var contentHandler: ((UNNotificationContent) -> Void)?
    var bestAttemptContent: UNMutableNotificationContent?

    override func didReceive(_ request: UNNotificationRequest, withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void) {
        self.contentHandler = contentHandler
        bestAttemptContent = (request.content.mutableCopy() as? UNMutableNotificationContent)
        
        // 从共享UserDefaults获取下一次闹钟的配置
        guard let defaults = UserDefaults(suiteName: "group.com.yourcompany.yourapp"),
              let nextAlarmTime = defaults.object(forKey: "nextAlarmTime") as? Date else {
            contentHandler(bestAttemptContent ?? request.content)
            return
        }
        
        // 创建并调度下一条本地通知
        let content = UNMutableNotificationContent()
        content.title = "下一次闹钟提醒"
        content.body = "你的闹钟将在\(nextAlarmTime.formatted(date: .omitted, time: .shortened))响起"
        content.sound = UNNotificationSound.default
        
        let triggerComponents = Calendar.current.dateComponents([.hour, .minute], from: nextAlarmTime)
        let trigger = UNCalendarNotificationTrigger(dateMatching: triggerComponents, repeats: false)
        let nextRequest = UNNotificationRequest(identifier: UUID().uuidString, content: content, trigger: trigger)
        
        UNUserNotificationCenter.current().add(nextRequest) { error in
            if let error = error {
                print("调度下一条闹钟失败: \(error.localizedDescription)")
            }
        }
        
        // 必须调用contentHandler，否则通知会延迟或不展示
        contentHandler(bestAttemptContent ?? request.content)
    }

    override func serviceExtensionTimeWillExpire() {
        // 如果执行时间快耗尽，直接返回原通知内容，避免通知失败
        if let contentHandler = contentHandler, let bestAttemptContent = bestAttemptContent {
            contentHandler(bestAttemptContent)
        }
    }
}

2. 结合Background Tasks框架（适合复杂操作） #

如果你的逻辑需要更长时间的处理（比如从服务器同步闹钟数据），可以搭配BackgroundTasks框架。但要注意：当App被杀死时，系统不一定会唤起主App，所以这个方法的可靠性不如Notification Service Extension。

关键步骤： #

• 在Info.plist中添加BGTaskSchedulerPermittedIdentifiers数组，添加你的后台任务ID（例如com.yourcompany.yourapp.refreshAlarm）
• 在主App启动代码（比如AppDelegate.application(_:didFinishLaunchingWithOptions:)）里注册后台任务：

  BGTaskScheduler.shared.register(forTaskWithIdentifier: "com.yourcompany.yourapp.refreshAlarm", using: nil) { task in
      self.handleRefreshAlarmTask(task: task as! BGAppRefreshTask)
  }
  

• 在UNUserNotificationCenterDelegate的回调中请求调度后台任务：

  func userNotificationCenter(_ center: UNUserNotificationCenter, didReceive response: UNNotificationResponse, withCompletionHandler completionHandler: @escaping () -> Void) {
      let taskRequest = BGAppRefreshTaskRequest(identifier: "com.yourcompany.yourapp.refreshAlarm")
      taskRequest.earliestBeginDate = Date(timeIntervalSinceNow: 1) // 尽快执行任务
      do {
          try BGTaskScheduler.shared.submit(taskRequest)
      } catch {
          print("提交后台任务失败: \(error.localizedDescription)")
      }
      completionHandler()
  }
  

• 实现handleRefreshAlarmTask方法，完成下一条通知的设置后，调用task.setTaskCompleted(success:)告知系统任务结束。

3. 必要的权限和配置检查 #

最后确保你的App已经正确配置了以下内容：

• 在Info.plist的UIBackgroundModes中添加fetch，开启后台刷新权限
• 已向用户申请UNAuthorizationOptions.alert、.sound等通知权限
• 如果使用App Groups，确认主App和Extension的Provisioning Profile都包含App Groups权限

注意事项 #

• Notification Service Extension的代码要尽量轻量化，避免阻塞操作（比如同步网络请求），否则系统会提前终止扩展
• 测试扩展时优先用真机，可通过Xcode的“Attach to Process”功能调试扩展代码
• 当App被杀死时，只有Notification Service Extension能保证执行代码，主App的回调大概率不会触发，所以这是首选方案

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