Swift更新Apple Contacts联系人失败问题排查求助

核心问题 #

更新功能失效的直接原因是：在查询已有联系人时，没有请求后续需要修改的字段。

从报错日志里的关键信息A property was not requested when contact was fetched.和调用栈指向-[CNMutableContact setPhoneNumbers:]可以看出：你在checkForExistingContact方法中获取联系人时，只请求了姓名和邮箱字段，但在updateContact中尝试修改phoneNumbers和postalAddresses这些未被请求的字段，违反了Contacts框架的规则——CNContact对象是只读的，只有在fetch时明确指定的字段，才能在转为CNMutableContact后修改。

修复步骤 #

修改checkForExistingContact方法中的keysToFetch数组，加入所有后续需要修改的字段，包括联系人ID（更新操作必须依赖ID）、电话、地址字段：

func checkForExistingContact(familyName: String, givenName: String) -> CNContact? {
    let store = CNContactStore()
    do {
        let predicate = CNContact.predicateForContacts(matchingName: familyName)
        // 补充所有需要访问/修改的字段Key
        let keysToFetch = [
            CNContactIdentifierKey,
            CNContactGivenNameKey,
            CNContactFamilyNameKey,
            CNContactEmailAddressesKey,
            CNContactPhoneNumbersKey,
            CNContactPostalAddressesKey
        ] as [CNKeyDescriptor]
        let contacts = try store.unifiedContacts(matching: predicate, keysToFetch: keysToFetch)
        for contact in contacts {
            if contact.givenName == givenName {
                return contact
            }
        }
        return nil
    } catch {
        print("Fetching contact failed, error: \(error)")
        return nil
    }
}

额外优化建议 #

1. 处理空邮箱的情况：原updateContact方法中，当mail为空时没有清空原有邮箱，若需要同步清空，可补充else分支：

if mail != "" {
    let homeEmail = CNLabeledValue(label: CNLabelHome, value: mail as NSString)
    mutableContact.emailAddresses = [homeEmail]
} else {
    mutableContact.emailAddresses = []
}

2. 错误日志完善：原方法中fetch失败仅返回nil，添加错误打印便于调试。

其他日志警告说明 #

日志中关于账号权限的警告（如Attempted to register account monitor for types client is not authorized to access）属于非关键性警告，不影响更新功能，只要你的App已获得通讯录读写权限即可正常运行。

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