iOS应用点击后台任务生成的本地通知时崩溃问题求助

数据老陈

2026-5-11

解决后台抓取后点击通知崩溃的问题

从你的崩溃日志和代码来看，这个问题的核心原因很明确：后台抓取任务的完成回调（completionHandler）被调用了不止一次，iOS系统严格要求application:performFetchWithCompletionHandler里的回调必须且只能执行一次，重复调用就会触发this request has been neutered的断言错误。

为什么前台正常后台崩溃？

当应用在前台触发后台抓取时，应用退到后台后网络任务完成，你调用一次回调就结束了流程；但当应用本身就在后台时，网络任务完成弹出通知，点击通知唤醒应用的过程中，你的代码可能因为异步逻辑管理不当，重复调用了后台抓取的completionHandler，导致系统判定任务违规。

具体修复步骤

1. 严格控制后台抓取回调的调用次数

在application(_:performFetchWithCompletionHandler:)里添加一个标记变量，确保回调只执行一次：

func application(_ application: UIApplication, performFetchWithCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
    var hasCalledCompletion = false
    
    // 你的网络任务逻辑
    executeNetworkTask { [weak self] result in
        guard !hasCalledCompletion else { return }
        hasCalledCompletion = true
        
        // 处理结果并展示通知
        self?.showNotification(title: "更新提醒", subtitle: "内容已更新", body: "点击查看详情", identifier: "bg_fetch_notification")
        
        // 根据实际网络结果选择对应的回调类型
        completionHandler(.newData)
    }
}

2. 优化通知类别的注册逻辑

你的showNotification方法每次调用都会重复注册通知类别，这不仅没必要，还可能带来潜在的状态冲突。把类别注册移到App启动时只执行一次：

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    // 初始化通知中心代理和权限请求
    UNUserNotificationCenter.current().delegate = self
    UNUserNotificationCenter.current().requestAuthorization(options: [.alert, .badge, .sound]) { granted, error in
        print(granted ? "Permission Granted" : "Permission Denied")
    }
    
    // 只注册一次通知类别
    let acceptAction = UNNotificationAction(identifier: "accept", title: "Accept", options: .foreground)
    let rejectAction = UNNotificationAction(identifier: "reject", title: "Reject", options: .destructive)
    let commentAction = UNTextInputNotificationAction(identifier: "comment", title: "Add Comment", options: .authenticationRequired, textInputButtonTitle: "Send", textInputPlaceholder: "Add Comment Here")
    let notificationCategory = UNNotificationCategory(identifier: "category_notification", actions: [acceptAction, rejectAction, commentAction], intentIdentifiers: [], options: [])
    
    UNUserNotificationCenter.current().setNotificationCategories([notificationCategory])
    
    return true
}

然后修改showNotification方法，移除重复的类别注册代码：

func showNotification(title: String, subtitle: String, body: String, identifier: String) {
    let content = UNMutableNotificationContent()
    content.badge = 1
    content.title = title
    content.subtitle = subtitle
    content.sound = UNNotificationSound.default
    content.categoryIdentifier = "category_notification"
    content.body = body
    
    let trigger = UNTimeIntervalNotificationTrigger(timeInterval: 1, repeats: false)
    let request = UNNotificationRequest(identifier: identifier, content: content, trigger: trigger)
    
    UNUserNotificationCenter.current().add(request) { error in
        if let error = error {
            print("添加通知失败：\(error.localizedDescription)")
        }
    }
}

3. 排查网络任务的重试逻辑

如果你的网络请求有自动重试机制，要确保重试成功后不会再次调用后台抓取的completionHandler——这是很容易忽略的重复调用场景。

最后测试

修改完成后，按以下流程验证：

让应用完全退到后台
在Xcode中触发「模拟后台抓取」
等待通知弹出后点击它，确认应用不再崩溃

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