如何解决从Firebase获取数据时出现的ListView范围错误？

我在从数据库加载并展示好友请求列表时，每当有新请求创建就会出现错误。原本以为是空值导致的问题，添加了空值检查条件后仍未解决。

相关代码 #

UserCubit.get(context).requestFriends.isEmpty
    ? Container(
        child: Center(child: Text('You have no requests')))
    : Container(
        height: height * 0.3,
        child: Flexible(
          child: ListView.separated(
              itemBuilder: (_, index) {
                return Container(
                  child: Row(
                    children: [
                      Text(
                          "${UserCubit.get(context).requestFriends[index]['nameSender']}"),
                    ],
                  ),
                );
              },
              separatorBuilder: (_, index) {
                return Padding(
                  padding: const EdgeInsets.symmetric(horizontal: 20),
                  child: Divider(
                    thickness: 1,
                    color: lightgrey,
                  ),
                );
              },
              itemCount: UserCubit.get(context)
                      .requestFriends
                      .length ==
                  0
                  ? 1
                  : UserCubit.get(context)
                      .requestFriends
                      .length),
        ),
      )

错误信息 #

从截图中可以看到核心错误：

• 类型转换失败：Null 无法转换为 String
• 调试控制台提示：type 'Null' is not a subtype of type 'String'

问题分析与修复 #

问题根源

你只检查了requestFriends列表是否为空，但列表中存在某一项的nameSender字段为null，直接通过字符串插值渲染时，Flutter会尝试将null转为字符串，触发类型转换错误。

修复步骤

1. 处理字段空值：在获取nameSender时添加空值兜底：

// 使用空值合并运算符
Text(UserCubit.get(context).requestFriends[index]['nameSender'] ?? '未知发送者')

// 或者条件判断
Text(
  UserCubit.get(context).requestFriends[index]['nameSender'] != null
      ? UserCubit.get(context).requestFriends[index]['nameSender']
      : '未知发送者'
)

2. 简化列表长度判断：外层已经判断了列表为空的情况，内层itemCount直接使用列表长度即可，无需重复判断：

itemCount: UserCubit.get(context).requestFriends.length

3. 推荐优化方案：避免直接操作Map数据，定义FriendRequest模型类，结合json序列化工具（如json_serializable）解析数据库返回的数据，这样能在编译阶段检查字段合法性，从根源减少空值问题。

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