如何从Firestore数组中获取特定值？Flutter实现优化方案咨询

我是Flutter及应用开发领域的新手，通过StreamBuilder从Firestore获取聊天房间文档数据构建聊天列表项时，遇到了一个小问题：每个聊天房间文档用usersName数组存储双方用户名，需要从中获取当前用户之外的聊天对象用户名。

现有代码能正常运行，但想寻求更简洁、高效的实现方式。以下是当前代码：

现有StreamBuilder代码 #

chatList() {
  return StreamBuilder(
    stream: chatRooms,
    builder: (context, snapshot) {
      return snapshot.hasData
        ? SingleChildScrollView(
          child: ListView.builder(
            itemCount: snapshot.data!.docs.length,
            shrinkWrap: true,
            itemBuilder: (context, index) {
              return ChatTile(
                chatRoomId: snapshot.data.docs[index].data()["chatRoomId"], 
                contactName: getContactName(List<String>
                    .from(snapshot.data.docs[index].data()['usersName'] as List))
                    .toString(),
                recentMessageText: 'test', 
                contactImagePath: '', 
                recentMessageTime: 1680069876235, 
                isRead: false);
            }),
        )
        : noChatHistory();
    }
  );
}

现有获取用户名方法 #

getContactName(List<String> nameList) {
  var targetUserName = StringBuffer();

  nameList.forEach((element) {
    if (element != currentUserName) {
      targetUserName.write(element);
    }
  });
    
  return targetUserName.toString();
}

优化建议 #

1. 简化用户名筛选逻辑

聊天房间仅包含双方用户，无需遍历整个数组，用firstWhere直接匹配第一个非当前用户的名称即可，同时增加异常兜底避免崩溃：

String getContactName(List<String> nameList) {
  return nameList.firstWhere(
    (name) => name != currentUserName,
    orElse: () => '未知联系人', // 处理数据异常情况
  );
}

如果后续需要支持多人群聊，可改用where+join拼接所有非当前用户的名称：

String getContactName(List<String> nameList) {
  return nameList.where((name) => name != currentUserName).join(', ');
}

2. 提升代码可读性与性能

在itemBuilder中先提取文档数据，避免重复调用snapshot.data.docs[index].data()，减少冗余操作：

itemBuilder: (context, index) {
  // 提取当前聊天房间的文档数据
  final chatRoomData = snapshot.data!.docs[index].data();
  // 安全转换usersName为List<String>，避免类型错误
  final usersName = chatRoomData['usersName'] is List 
      ? List<String>.from(chatRoomData['usersName']) 
      : [];
  // 获取联系人名称
  final contactName = getContactName(usersName);

  return ChatTile(
    chatRoomId: chatRoomData["chatRoomId"], 
    contactName: contactName,
    recentMessageText: 'test', 
    contactImagePath: '', 
    recentMessageTime: 1680069876235, 
    isRead: false,
  );
}

3. 修复滚动组件嵌套问题

SingleChildScrollView嵌套ListView会导致滚动冲突，且shrinkWrap: true会降低列表渲染性能。直接使用ListView即可，若列表外层已有滚动容器，可禁用自身滚动：

return snapshot.hasData
  ? ListView.builder(
      itemCount: snapshot.data!.docs.length,
      shrinkWrap: true,
      // 外层有滚动容器时添加，否则移除
      physics: const NeverScrollableScrollPhysics(), 
      itemBuilder: (context, index) {
        // ... 优化后的itemBuilder逻辑
      },
    )
  : noChatHistory();

4. 增强空安全与数据校验

Firestore返回的数据可能存在字段缺失或类型错误，增加校验避免崩溃：

// 校验chatRoomId是否存在，兜底默认值
final chatRoomId = chatRoomData["chatRoomId"] as String? ?? '未知房间';

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