看起来你遇到了两个核心问题：调用ContactsService.addContact()时抛出FormatException: Invalid envelope，以及联系人无法同步到系统通讯录。咱们一步步来解决：

1. 先修复未捕获的异步异常 #

你的代码里ContactsService.addContact()是一个异步方法，但你没有用await调用它，导致异常无法被外层的try-catch捕获，出现了未处理的异常。这是第一个要修正的点：

把方法改成异步，并await添加联系人的操作：

Future<void> saveContactInPhone() async { // 改为async方法
  try {
    print("saving Contact");
    Contact contact = Contact();
    print("fi");
    contact.displayName = myController1.text ;
    contact.phones = [Item(label: "mobile", value: myController4.text)];
    contact.company = myController2.text;
    print("fi2");
    await ContactsService.addContact(contact); // 添加await
    print("Contact saved to system address book");
  } catch (e) {
    print("Error saving contact: $e"); // 现在能捕获到异常了
  }
}

2. 解决FormatException: Invalid envelope #

这个错误通常是平台通道传递的参数格式不符合要求，或者缺少必要权限导致的，我们从以下几个方面排查：

（1）确保拥有通讯录写入权限 #

如果没有权限，不仅无法同步到系统通讯录，还可能触发参数格式异常：

• Android：在android/app/src/main/AndroidManifest.xml中添加权限：

  <uses-permission android:name="android.permission.WRITE_CONTACTS"/>
  <uses-permission android:name="android.permission.READ_CONTACTS"/>
  

  然后用permission_handler库动态请求权限（不要只依赖Manifest声明）。

• iOS：在ios/Runner/Info.plist中添加权限描述：

  <key>NSContactsUsageDescription</key>
  <string>需要访问通讯录来保存识别到的名片信息</string>
  

在代码里添加权限检查逻辑，确保有权限再执行添加操作：

// 在saveContactInPhone开头添加权限检查
bool hasPermission = await ContactsService.hasPermission();
if (!hasPermission) {
  hasPermission = await ContactsService.requestPermission();
  if (!hasPermission) {
    print("用户拒绝了通讯录权限，无法保存联系人");
    return;
  }
}

（2）验证输入字段的有效性 #

空值或非法格式的字段会导致平台通道解析失败：

• 确保displayName不为空（系统通讯录通常要求必填）
• 清理电话号码中的非数字字符（比如空格、括号、横杠），避免格式错误：

  String cleanPhone = myController4.text.replaceAll(RegExp(r'[^0-9+]'), ''); // 保留数字和+号（用于国家代码）
  contact.phones = [Item(label: "mobile", value: cleanPhone)];
  

• 如果启用邮箱字段，也要确保邮箱格式合法，且不为空再添加。

（3）升级contacts_service库版本 #

旧版本的库可能存在平台通道参数解析的bug，建议在pubspec.yaml中升级到最新稳定版：

dependencies:
  contacts_service: ^最新版本号 # 去pub.dev查看最新版本

3. 验证联系人同步到系统通讯录 #

完成以上修改后，重新运行应用，测试添加联系人：

• 确保权限请求弹窗被允许
• 检查系统自带的通讯录应用，确认联系人是否存在

如果还是有问题，可以尝试打印完整的contact对象，查看是否有异常字段，或者测试手动构造一个简单的Contact对象（比如固定的displayName和手机号），排查是否是输入数据的问题。

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