UNNotificationServiceExtension调用enumerateContacts时异常退出问题咨询

我之前在做Notification Extension处理联系人匹配的时候也踩过这个坑，太懂你的困扰了！咱们来拆解下问题原因，再给你靠谱的解决方案：

问题根源 #

UNNotificationServiceExtension的运行环境非常受限：系统给它的执行时间很短（通常只有几秒），内存配额也很低。而enumerateContacts(with:keysToFetch:)这个方法是逐个遍历符合条件的联系人，如果你的联系人数量多，或者没有设置精准的过滤条件，这个遍历过程很容易超时，系统就会直接终止扩展进程，导致方法根本没机会返回结果。

而unifiedContacts(matching:predicate, keysToFetch:keys)是一次性返回所有匹配的联系人结果，查询效率高得多，能在Extension的时间限制内完成，所以能正常返回。

最优解决方案：优先用unifiedContacts精准查询 #

既然你的需求是把通知里的电话号码替换成联系人姓名，完全不需要遍历所有联系人——直接用电话号码生成谓词，精准查询对应的联系人就好，既高效又不会触发超时。

给你写个示例代码，直接就能用：

import UserNotifications
import Contacts

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 content = bestAttemptContent else {
            contentHandler(request.content)
            return
        }
        
        // 核心逻辑：替换电话号码为联系人姓名
        replacePhoneNumberWithContactName(in: content)
        
        contentHandler(content)
    }
    
    private func replacePhoneNumberWithContactName(in content: UNMutableNotificationContent) {
        guard let body = content.body else { return }
        
        // 提取通知里的"Ph#"格式电话号码（这里可以根据你的实际格式调整正则）
        let phoneRegexPattern = "Ph#(\\d{10,11})" // 假设是10-11位数字
        guard let regex = try? NSRegularExpression(pattern: phoneRegexPattern) else { return }
        
        let matches = regex.matches(in: body, range: NSRange(body.startIndex..., in: body))
        let contactStore = CNContactStore()
        // 只请求需要的字段，减少内存占用
        let requiredKeys = [CNContactGivenNameKey, CNContactFamilyNameKey] as [CNKeyDescriptor]
        
        for match in matches {
            guard let phoneNumberRange = Range(match.range(at: 1), in: body) else { continue }
            let targetPhoneNumber = String(body[phoneNumberRange])
            
            // 用电话号码生成精准查询谓词
            let predicate = CNContact.predicateForContacts(matching: CNPhoneNumber(stringValue: targetPhoneNumber))
            
            do {
                let matchedContacts = try contactStore.unifiedContacts(matching: predicate, keysToFetch: requiredKeys)
                if let firstContact = matchedContacts.first {
                    let contactName = "\(firstContact.givenName) \(firstContact.familyName)".trimmingCharacters(in: .whitespaces)
                    // 替换通知内容里的占位符
                    content.body = content.body.replacingOccurrences(of: "Ph#\(targetPhoneNumber)", with: contactName)
                }
            } catch {
                print("查询联系人失败：\(error.localizedDescription)")
            }
        }
    }

    override func serviceExtensionTimeWillExpire() {
        // 超时 fallback，返回原始内容
        if let contentHandler = contentHandler, let bestAttemptContent = bestAttemptContent {
            contentHandler(bestAttemptContent)
        }
    }
}

如果一定要用enumerateContacts怎么办？ #

如果你有特殊场景必须用这个方法，一定要注意两点：

• 加精准谓词过滤：绝对不要遍历所有联系人，用predicate把查询范围缩到最小
• 找到目标立刻停止：在enumerateContacts的回调里，一旦找到匹配的联系人，立刻调用enumerator.stop()终止遍历，避免超时

示例代码片段：

do {
    try contactStore.enumerateContacts(with: predicate, keysToFetch: requiredKeys) { contact, stop in
        // 找到目标联系人
        let contactName = "\(contact.givenName) \(contact.familyName)"
        content.body = content.body.replacingOccurrences(of: "Ph#\(targetPhoneNumber)", with: contactName)
        // 立刻停止遍历
        stop.pointee = true
    }
} catch {
    print("遍历联系人失败：\(error.localizedDescription)")
}

额外注意事项 #

1. 权限配置：确保主App的Info.plist里添加了NSContactsUsageDescription字段，说明访问联系人的原因，并且用户已经授权了联系人访问权限（Extension会共享主App的权限）
2. 字段最小化：查询联系人时只请求需要的字段（比如示例里只请求姓名），不要请求所有字段，减少内存占用和查询时间

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