Flutter应用获取联系人列表：终端有数据但界面不显示且重复打印

你的代码存在几个关键问题，导致界面无法展示联系人，同时还有打印错误和重复显示号码的问题，以下是修正方案：

问题分析 #

1. 异步处理错误：initState里直接把getContacts()赋值给_contacts，但getContacts是异步函数，返回的是Future，不是联系人数组，导致_contacts根本不是有效数据集合。
2. 数据未存入状态变量：getContacts函数仅打印联系人，没有将获取到的联系人列表赋值给_contacts，界面自然拿不到数据。
3. 电话号码打印错误：打印语句里输出的是contact.phones!.isNotEmpty（布尔值），不是实际的电话号码。
4. 号码重复显示：遍历电话号码时，每次都取contact.phones!.first.value，导致每个号码位置都显示第一个号码，没有使用当前遍历的phoneNumber。
5. 重复联系人问题：ContactsService.getContacts()默认可能返回重复条目，可以通过参数或手动去重处理。

修正后的完整代码 #

class ContactsPage extends Stateful Widget {
  @override
  _ContactsPageState createState() => _ContactsPageState();
}

class _ContactsPageState extends State<ContactsPage> {
  List<Contact> _contacts = [];
  bool _isLoading = true; // 增加加载状态，提升用户体验

  @override
  void initState() {
    super.initState();
    _fetchContacts(); // 调用异步方法获取联系人
  }

  // 重构异步方法，处理状态更新
  Future<void> _fetchContacts() async {
    // 请求联系人权限（如果还没处理权限，需要先添加权限配置）
    PermissionStatus status = await Permission.contacts.request();
    if (status.isGranted) {
      // 获取联系人，添加withThumbnails: false减少重复和冗余数据
      Iterable<Contact> contacts = await ContactsService.getContacts(withThumbnails: false);
      // 手动去重：根据displayName和phoneNumber组合去重（可选，根据需求调整）
      List<Contact> uniqueContacts = [];
      Set<String> contactKeys = {};
      for (var contact in contacts) {
        String key = '${contact.displayName ?? ''}_${contact.phones?.first.value ?? ''}';
        if (!contactKeys.contains(key)) {
          contactKeys.add(key);
          uniqueContacts.add(contact);
        }
        // 正确打印联系人信息
        print('Name: ${contact.displayName ?? '无姓名'}');
        print('Phone number: ${contact.phones?.isNotEmpty == true ? contact.phones!.first.value : '无号码'}');
      }
      // 更新状态，刷新界面
      setState(() {
        _contacts = uniqueContacts;
        _isLoading = false;
      });
    } else {
      setState(() {
        _isLoading = false;
      });
      // 权限被拒绝时提示用户
      ScaffoldMessenger.of(context).showSnackBar(
        SnackBar(content: Text('需要联系人权限才能查看列表')),
      );
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Contacts List'),
      ),
      body: _isLoading
          ? const Center(child: CircularProgressIndicator()) // 加载中显示进度圈
          : ListView.builder(
              itemCount: _contacts.length,
              itemBuilder: (context, index) {
                Contact contact = _contacts[index];
                List<Item> phoneNumbers = contact.phones?.toList() ?? [];

                return ListTile(
                  title: Text(contact.displayName ?? '无姓名'),
                  subtitle: Column(
                    crossAxisAlignment: CrossAxisAlignment.start,
                    children: phoneNumbers.map((Item phoneNumber) {
                      // 使用当前遍历的phoneNumber的value，不再重复显示第一个号码
                      return Text(phoneNumber.value ?? '无号码');
                    }).toList(),
                  ),
                );
              },
            ),
    );
  }
}

关键修改点说明 #

• 异步处理：将getContacts改为_fetchContacts异步方法，在initState中调用，通过setState更新状态，确保数据获取后刷新界面。
• 权限处理：增加联系人权限请求，避免因权限问题导致获取失败（需要在pubspec.yaml添加permission_handler依赖，同时在Android/iOS配置权限）。
• 数据去重：通过组合姓名和号码生成唯一key，过滤重复联系人，解决终端打印重复的问题。
• 正确显示号码：遍历电话号码时使用phoneNumber.value，每个号码显示对应的值，不再重复第一个号码。
• 加载状态：增加_isLoading变量，数据获取过程中显示进度圈，提升用户体验。
• 空值处理：对displayName和phoneNumber.value添加空值判断，避免空指针异常。

额外配置提示 #

1. 添加依赖到pubspec.yaml：

dependencies:
  flutter:
    sdk: flutter
  contacts_service: ^0.6.3
  permission_handler: ^10.2.0

2. Android端：在AndroidManifest.xml中添加权限：

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

3. iOS端：在Info.plist中添加权限描述：

<key>NSContactsUsageDescription</key>
<string>需要访问您的联系人以展示列表</string>

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