Flutter从Firestore查询用户邮箱触发RangeError索引越界问题

问题根源 #

你直接通过value.docs[0]获取第一个查询结果，但当搜索的邮箱不存在（或输入有误、大小写不匹配）时，value.docs是空数组，访问索引0自然会触发越界异常。

修复方案 #

修改onSearch方法，先判断查询结果是否为空，同时增加异常处理：

void onSearch() async {
  FirebaseFirestore _firestore = FirebaseFirestore.instance;
  setState(() {
    isLoading = true;
  });
  
  try {
    // 先trim掉输入的空格，避免不必要的空查询
    final searchEmail = _serachBarController.text.trim();
    final querySnapshot = await _firestore.collection('users')
        .where('email', isEqualTo: searchEmail)
        .get();
    
    setState(() {
      isLoading = false;
    });
    
    if (querySnapshot.docs.isNotEmpty) {
      userMap = querySnapshot.docs[0].data();
      print(userMap);
      // 这里可以添加找到用户后的逻辑，比如展示用户信息或跳转聊天页
    } else {
      // 没找到用户时给个提示
      ScaffoldMessenger.of(context).showSnackBar(
        const SnackBar(content: Text('未找到该邮箱对应的用户')),
      );
    }
  } catch (e) {
    setState(() {
      isLoading = false;
    });
    // 处理查询时的异常
    ScaffoldMessenger.of(context).showSnackBar(
      SnackBar(content: Text('搜索失败：$e')),
    );
  }
}

额外优化点 #

1. 给userMap初始化，避免未初始化问题：把late Map<String, dynamic> userMap;改成Map<String, dynamic> userMap = {};
2. 可以给搜索输入框加邮箱格式验证，比如用正则判断，减少无效查询
3. 搜索按钮可以在输入为空时置灰，避免空查询

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