Flutter使用contacts_service获取联系人遇RangeError索引越界求助

问题根源 #

你遇到的RangeError (index): Invalid value: Valid value range is empty: 0，核心原因是部分联系人未保存电话号码——你直接调用contact.phones!.elementAt(0)时，空列表无法获取索引0的元素，触发崩溃。另外原代码缺少权限主动请求逻辑，可能导致联系人数据获取不完整。

修复方案（contacts_service版本） #

1. 处理空电话号码的边界情况 #

修改ListTile的subtitle部分，先判断电话号码列表是否为空，避免直接访问空索引：

subtitle: Text(
  contact.phones?.isNotEmpty == true 
    ? contact.phones!.first.value.toString() 
    : "无电话号码"
),

2. 补充权限请求逻辑 #

使用permission_handler先申请联系人权限，确保权限授予后再获取联系人：

import 'package:permission_handler/permission_handler.dart';

// ... 其他代码不变

void getAllContacts() async {
  // 请求读取联系人权限
  final status = await Permission.contacts.request();
  if (status.isGranted) {
    final _contacts = await ContactsService.getContacts(withThumbnails: false);
    setState(() => contacts = _contacts);
  } else {
    // 权限被拒绝时提示用户
    ScaffoldMessenger.of(context).showSnackBar(
      const SnackBar(content: Text("需要联系人权限才能获取联系人")),
    );
  }
}

3. 处理displayName为空的情况 #

部分联系人可能未设置显示名称，直接使用contact.displayName!会触发空指针，建议补充空判断：

title: Text(contact.displayName ?? "未知联系人"),

flutter_contacts插件的修复方案 #

flutter_contacts的getContacts默认不会获取电话号码等附加信息，需要指定withProperties: true参数，同时同样要处理空号码：

import 'package:flutter_contacts/flutter_contacts.dart';

// 获取联系人的方法
void getAllContacts() async {
  final status = await Permission.contacts.request();
  if (status.isGranted) {
    if (await FlutterContacts.requestPermission()) {
      final contacts = await FlutterContacts.getContacts(withProperties: true);
      setState(() => this.contacts = contacts);
    }
  }
}

// 构建ListTile时的处理
subtitle: Text(
  contact.phones.isNotEmpty 
    ? contact.phones.first.number 
    : "无电话号码"
),

额外注意事项 #

• Android 13及以上版本需单独请求READ_CONTACTS权限，你的AndroidManifest.xml配置已符合要求，但权限请求逻辑不可省略。
• 测试时需覆盖两种情况：有电话号码的联系人、无电话号码的联系人，验证边界场景。

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