如何在Future返回空列表时条件化显示提示信息？

我用FutureBuilder从Supabase后端获取条目列表，希望在数据库连接成功但无记录可显示时，展示一段提示文本。目前加载状态（圆形进度指示器）和错误状态（错误提示）都能正常工作，但无数据时的提示逻辑始终不触发，相关代码如下：

FutureBuilder(
  future: transactionRepo.getTxnsAndRelvars(),
  builder: (BuildContext context, AsyncSnapshot snapshot) {
    if (snapshot.connectionState == ConnectionState.waiting) {
      return CircularProgressIndicator.adaptive();
    } else if (snapshot.hasError) {
      return Center(child: Text('Error! ${snapshot.error}'));
    } else if (!snapshot.hasData) {
      return Text('No data present!'); // 1 从未触发
    } else {
      return ListView.builder(
        itemCount: snapshot.data?.length,
        itemBuilder: (context, index) {
          if (snapshot.data.length > 0) {
            return GestureDetector(...); // 条目列表
              } else {
                return Center(
                  child: Text('No Transactions Yet!'),
                );
              }
            },
          );
        }
      },
    );

问题根源 #

1. !snapshot.hasData不触发：你的getTxnsAndRelvars()在无数据时返回的是空列表[]，而非null。snapshot.hasData仅判断数据是否为null，空列表属于有效非null数据，因此该分支永远不会执行。
2. itemBuilder的else分支不触发：当数据为空列表时，itemCount为0，ListView.builder不会调用itemBuilder，自然走不到else分支。

修复后的代码 #

FutureBuilder(
  future: transactionRepo.getTxnsAndRelvars(),
  builder: (BuildContext context, AsyncSnapshot snapshot) {
    if (snapshot.connectionState == ConnectionState.waiting) {
      return CircularProgressIndicator.adaptive();
    } else if (snapshot.hasError) {
      return Center(child: Text('Error! ${snapshot.error}'));
    } 
    // 处理可能的null值，统一转为列表
    final dataList = snapshot.data ?? [];
    // 列表为空时直接返回提示
    if (dataList.isEmpty) {
      return Center(child: Text('No Transactions Yet!'));
    }
    // 有数据时渲染列表
    return ListView.builder(
      itemCount: dataList.length,
      itemBuilder: (context, index) {
        return GestureDetector(...); // 你的条目组件
      },
    );
  },
);

关键优化点 #

• 用snapshot.data ?? []处理可能的null值，避免后续空指针问题
• 提前判断列表是否为空，直接返回空状态提示，无需进入列表渲染逻辑
• 移除itemBuilder中无效的长度判断，因为只有列表非空时才会执行到这里

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