Flutter开发银行应用出现Null check operator used on a null value错误如何解决

API 探路者

2026-10-3

报错根因

你的FutureBuilder判断逻辑完全写反了，空安全报错就是逻辑分支错误导致的空值调用：
当snapshot.hasData为true且数据长度大于0时，你返回了Container，反而在不满足该条件（包括加载中、无数据、snapshot.data本身为null）时进入ListView.builder分支，此时你对空的snapshot.data使用!强制非空断言，直接触发报错。
同时你没有处理Future的加载中、加载失败状态，属于FutureBuilder的典型使用错误。

修复代码

Widget projectWidget() {
  return FutureBuilder<List<Histories>>(
    future: dbHelper.getHistories(),
    builder: (context, snapshot) {
      // 处理加载中状态
      if (snapshot.connectionState == ConnectionState.waiting) {
        return const Center(child: CircularProgressIndicator());
      }
      // 处理加载失败状态
      if (snapshot.hasError) {
        return Center(child: Text('加载失败：${snapshot.error}'));
      }
      // 空值兜底，避免直接使用!断言
      final List<Histories> historiesList = snapshot.data ?? [];
      // 无数据时返回空提示
      if (historiesList.isEmpty) {
        return const Center(child: Text('暂无历史记录'));
      }
      // 有数据才渲染列表
      return ListView.builder(
        itemCount: historiesList.length,
        itemBuilder: (context, index) {
          Histories histories = historiesList[index];
          // 替换为你的实际列表项布局
          return Container();
        },
      );
    });
}