Flutter中contacts_service插件更新及批量添加联系人异常求助

问题1：更新联系人时手机号丢失或联系人被删除 #

问题分析 #

你的代码存在两个核心问题：

• 变量名错误：修改的是duplicateContact，但调用updateContact时传入未修改的contact，导致更新无效甚至覆盖原始数据。
• 未保留联系人唯一ID：更新联系人必须依赖原始联系人的id字段，否则插件无法定位目标，可能导致误删或创建新联系人。

修复代码 #

// 从系统获取的原始联系人（必须包含id）
Contact originalContact = <old contact from system>;

// 基于原始联系人创建更新实例，保留id
final updatedContact = Contact(
  id: originalContact.id,
  givenName: <new name>,
  company: <company name>,
  phones: [Item(value: mobile, label: "mobile")],
  // 可选：保留其他不需要修改的字段，比如邮箱、地址等
  emails: originalContact.emails,
);

// 调用更新时传入修改后的实例
await ContactsService.updateContact(updatedContact);

// 循环更新时添加短暂延迟，避免触发系统频率限制
await Future.delayed(const Duration(milliseconds: 100));

额外注意 #

• 循环更新时必须串行执行（用await），并加入延迟，避免系统处理不过来导致异常。
• 确保更新前已获取到完整的原始联系人（包含所有必要字段，尤其是id）。

问题2：批量添加联系人时手机号被合并到其他联系人 #

问题分析 #

该问题通常由两个原因导致：

1. 系统联系人自动合并机制：当多个联系人姓名/手机号高度相似时，Android/iOS系统会自动合并重复联系人。
2. 批量添加速度过快：系统未及时处理完前一个联系人的添加请求，导致后续请求的信息被误关联。

解决方案 #

for (var element in contactData) {
  final contact = Contact(
    phones: [Item(value: element.mobileNo, label: "mobile")],
    givenName: element.name,
    company: element.companyName,
    // 添加唯一标识字段（如临时中间名），避免系统自动合并
    middleName: "batch_temp_${element.mobileNo}",
  );

  try {
    await ContactsService.addContact(contact);
    
    // 可选：添加完成后移除临时中间名
    final updatedContact = contact.copyWith(middleName: null);
    await ContactsService.updateContact(updatedContact);
  } catch (e) {
    print("添加联系人失败: ${element.name} - $e");
    // 可选：失败后重试1次
    await Future.delayed(const Duration(milliseconds: 300));
    await ContactsService.addContact(contact);
  }

  // 延长间隔时间，确保系统有足够时间处理每个联系人
  await Future.delayed(const Duration(milliseconds: 200));
}

额外注意 #

• 确保每个联系人的手机号唯一（业务允许的情况下），从根源避免合并。
• 在真实设备上测试，模拟器的联系人合并规则可能与真机不同。
• 检查权限是否完全授予（读写联系人权限必须在运行时申请并通过）。

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