使用CNContactViewController编辑联系人时新建而非更新原联系人问题

问题根源 #

你当前使用CNContactViewController(for: contact)初始化控制器，传入的CNContact是不可变对象，若该对象缺少系统通讯录的持久化标识符（persistent identifier），系统无法关联到原有联系人，编辑完成后会默认创建新条目。

解决方案 #

要实现编辑更新原有联系人，需按以下步骤修改代码：

1. 确保获取联系人时包含标识符字段
   获取联系人时，必须请求CNContactIdentifierKey，确保拿到的联系人带有系统唯一标识：

   let requiredKeys: [CNKeyDescriptor] = [
       CNContactIdentifierKey,
       CNContactGivenNameKey,
       CNContactFamilyNameKey,
       // 添加你需要展示/编辑的其他字段
   ]
   

2. 修改控制器初始化方式
   使用编辑专用的初始化方法，传入可变的CNMutableContact对象，并设置contactStore：

   func showContactDetails(for contact: CNContact) {
       // 将不可变联系人转为可变对象
       guard let mutableContact = contact.mutableCopy() as? CNMutableContact else {
           return
       }
       
       // 使用编辑模式初始化控制器
       let contactVC = CNContactViewController(forEditing: mutableContact)
       contactVC.hidesBottomBarWhenPushed = true
       contactVC.allowsActions = true
       contactVC.delegate = self
       // 必须设置contactStore，否则无法关联系统通讯录
       contactVC.contactStore = CNContactStore()
       
       navigationController?.pushViewController(contactVC, animated: true)
   }
   

3. 实现代理方法完成保存
   通过CNContactViewControllerDelegate方法手动执行联系人更新操作：

   extension YourViewController: CNContactViewControllerDelegate {
       func contactViewController(_ viewController: CNContactViewController, didCompleteWith contact: CNContact?) {
           navigationController?.popViewController(animated: true)
           
           guard let editedContact = contact as? CNMutableContact else {
               return
           }
           
           // 执行更新请求
           let store = CNContactStore()
           let saveRequest = CNSaveRequest()
           saveRequest.update(editedContact)
           
           do {
               try store.execute(saveRequest)
           } catch {
               print("联系人保存失败：\(error.localizedDescription)")
           }
       }
   }
   

4. 权限配置
   确保Info.plist中已添加通讯录访问权限描述：

   <key>NSContactsUsageDescription</key>
   <string>需要访问通讯录以编辑联系人信息</string>
   

关键注意点 #

• 必须使用CNContactViewController(forEditing:)而非for:初始化控制器
• 必须传入CNMutableContact对象，保证可编辑
• 必须设置contactStore属性，让控制器关联系统通讯录
• 通过CNSaveRequest手动执行更新，确保原有联系人被修改而非新建

内容的提问来源于stack exchange，提问作者Codebane the Swiftbreaker