.NET MAUI调用Contacts.PickContactAsync始终返回null，求问题排查

以下是几个常见原因及对应解决办法：

• 权限未正确配置或授予
  不同平台需要明确的通讯录访问权限：

  • Android：在AndroidManifest.xml中添加权限声明：

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

    并在代码中动态请求权限：

    var status = await Permissions.RequestAsync<Permissions.ContactsRead>();
    if (status != PermissionStatus.Granted)
    {
        // 权限未授予，提示用户或做其他处理
        return;
    }
    

  • iOS：在Info.plist中添加权限说明（系统要求必须提供用途描述）：

    <key>NSContactsUsageDescription</key>
    <string>需要访问通讯录以选择联系人</string>
    

• 用户取消了选择操作
  当用户打开联系人选择器后未选中任何联系人直接返回，PickContactAsync会返回null。这是正常行为，可在代码中做判断处理：

  var contact = await Microsoft.Maui.ApplicationModel.Communication.Contacts.PickContactAsync();
  if (contact == null)
  {
      // 用户取消选择，执行对应逻辑
      return;
  }
  // 处理选中的联系人数据
  

• 平台特定配置缺失

  • Android 13+：确保项目目标SDK版本符合要求，且权限声明正确，部分设备可能需要额外验证权限是否被系统授予。
  • iOS：检查项目Capabilities中是否开启了Contacts权限，或确认Info.plist的权限描述未被遗漏，否则系统会直接拦截通讯录访问请求。

• 未在UI线程调用API
  PickContactAsync需要与系统UI交互，若在后台线程调用可能导致返回null或异常。可通过主线程调用确保正常执行：

  var contact = await MainThread.InvokeOnMainThreadAsync(async () => 
      await Microsoft.Maui.ApplicationModel.Communication.Contacts.PickContactAsync());
  

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