从主Target构建应用时Notification Extension自定义函数未执行

核心原因 #

UNNotificationServiceExtension的生命周期严格受系统限制：一旦调用contentHandler，系统就判定扩展任务已完成，会在极短时间内终止扩展进程。你代码里用DispatchQueue.main.asyncAfter延迟30秒调用apiCall()，此时扩展进程早就被系统杀死，自然无法执行。

而选择extension target直接运行时，调试环境会延长扩展进程的存活时间，或测试流程直接触发扩展进程，所以延迟任务能正常执行，但这不符合真实环境逻辑。

解决方案 #

1. 调整任务执行逻辑，确保关键操作在扩展存活期内完成

不要在调用contentHandler后执行异步任务，应等待所有需要处理的操作（比如apiCall()）完成后，再修改通知内容并调用contentHandler，同时通过serviceExtensionTimeWillExpire处理系统超时情况。

修改后的代码示例：

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)
        
        guard let bestAttemptContent = bestAttemptContent else {
            contentHandler(request.content)
            return
        }
        
        // 先做基础修改
        bestAttemptContent.title = "[modified]"
        bestAttemptContent.body = "[modified]"

        // 执行API调用，在回调中完成最终处理
        apiCall { [weak self] result in
            guard let self = self, let contentHandler = self.contentHandler else { return }
            
            // 根据API结果修改通知内容
            if let data = result {
                bestAttemptContent.subtitle = "API返回: \(data)"
            }
            
            // 调用contentHandler，通知系统任务完成
            contentHandler(bestAttemptContent)
        }
    }
    
    override func serviceExtensionTimeWillExpire() {
        // 系统即将终止扩展，返回当前已修改的内容
        if let contentHandler = contentHandler, let bestAttemptContent = bestAttemptContent {
            contentHandler(bestAttemptContent)
        }
    }
    
    // 假设apiCall是带回调的异步函数
    private func apiCall(completion: @escaping (String?) -> Void) {
        // 模拟网络请求
        DispatchQueue.global().asyncAfter(deadline: .now() + 5) {
            completion("成功获取数据")
        }
    }
}

2. 主Target运行时调试扩展的正确方式

主应用运行时，扩展是独立进程，默认不会自动附加调试器。要调试自定义函数：

• 运行主应用，保持Xcode处于调试状态
• 当推送通知到达、扩展被触发时，在Xcode顶部菜单选择Debug -> Attach to Process，找到你的NotificationExtension进程（进程名通常和扩展target一致）
• 这样就能在自定义函数中打断点调试

关键注意事项 #

• 扩展存活时间非常有限（系统通常只给几秒到十几秒），所以apiCall()必须是耗时极短的操作，否则会触发超时，系统会使用serviceExtensionTimeWillExpire中返回的"最佳尝试"内容
• 不要在扩展中执行长时间运行的任务，这不符合iOS扩展的设计初衷

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