iOS后台运行时本地通知偶尔无法触发的问题排查

数据老陈

2026-6-23

问题分析与解决方案

是否属于预期情况？

是。iOS对后台应用的执行有严格的资源限制：当应用进入后台挂起状态后，DispatchSourceTimer会被系统暂停甚至终止，无法保证每5分钟稳定触发，这直接导致你的通知调度逻辑无法按时执行，最终出现通知不触发的情况。

核心问题与修正方案

1. 放弃手动维护后台定时器，直接利用UserNotifications框架调度重复通知

你当前的做法是通过定时器触发后再调度一个5秒后执行的单次通知，这完全没必要——UserNotifications本身支持系统级的重复通知调度，由系统负责在后台精准触发，比手动定时器可靠得多。

修改代码如下：

private func setupRepeatingNotification() {
    // 先移除之前的重复通知（用固定标识）
    let notificationIdentifier = "com.yourapp.repeating_reminder"
    UNUserNotificationCenter.current().removePendingNotificationRequests(withIdentifiers: [notificationIdentifier])
    
    let content = UNMutableNotificationContent()
    content.title = "你的标题"
    content.body = "你的内容"
    content.sound = UNNotificationSound.default

    // 设置5分钟（300秒）重复触发的触发器
    let trigger = UNTimeIntervalNotificationTrigger(timeInterval: 300, repeats: true)
    let request = UNNotificationRequest(identifier: notificationIdentifier, content: content, trigger: trigger)

    UNUserNotificationCenter.current().add(request) { error in
        if let error = error {
            print("Error scheduling repeating notification: \(error)")
        }
    }
}

只需在应用启动或用户开启功能时调用一次setupRepeatingNotification，系统就会自动每5分钟触发通知，无需后台定时器介入。

2. 若必须在后台执行自定义逻辑后再发通知，使用BGTaskScheduler

如果你的业务需要在通知触发前执行一些后台逻辑（比如获取最新数据），则需要通过BGTaskScheduler申请后台执行时间：

第一步：在Info.plist中添加UIBackgroundModes数组，包含processing项；
第二步：注册后台任务并调度：

import BackgroundTasks

// 在AppDelegate或SceneDelegate的启动方法中注册任务
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    BGTaskScheduler.shared.register(forTaskWithIdentifier: "com.yourapp.process_notification", using: nil) { task in
        self.handleNotificationTask(task: task as! BGProcessingTask)
    }
    return true
}

// 调度后台任务（比如应用进入后台时调用）
func scheduleBackgroundTask() {
    let request = BGProcessingTaskRequest(identifier: "com.yourapp.process_notification")
    request.requiresNetworkConnectivity = false // 根据需求设置
    request.requiresExternalPower = false
    request.earliestBeginDate = Date(timeIntervalSinceNow: 300) // 5分钟后执行
    
    do {
        try BGTaskScheduler.shared.submit(request)
    } catch {
        print("Could not schedule task: \(error)")
    }
}

// 处理后台任务逻辑
private func handleNotificationTask(task: BGProcessingTask) {
    // 标记任务为需要重新调度（确保下一次继续执行）
    scheduleBackgroundTask()
    
    // 执行你的自定义逻辑，比如更新通知内容
    scheduleNotification()
    
    // 任务完成后调用setTaskCompleted
    task.setTaskCompleted(success: true)
}

这样系统会在后台为你的应用分配短暂的执行时间，确保调度逻辑能被执行。

3. 优化通知管理逻辑

不要每次调用removeAllPendingNotifications()，这会清除所有未触发的通知，包括你刚调度的。建议使用固定的通知标识符，只移除对应标识符的通知，避免误删；
检查通知权限：确保用户已授予UNAuthorizationOptions.alert、UNAuthorizationOptions.sound等权限，并且在系统设置中开启了应用的通知权限。

4. QoS等级的作用有限

修改队列QoS等级无法解决后台挂起的核心问题——当应用被系统挂起后，无论队列优先级多高，都无法执行代码。QoS仅能在应用处于活跃/后台运行状态时，影响任务的执行优先级。

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