Flutter获取Firebase云存储文件夹名在ListView展示及报错排查

代码报错和功能异常由以下几个问题共同导致：

• LateInitializationError直接原因：你声明了类成员变量late Future<List<FirebaseFolder>> listResult但从未给它赋值，getFolders()方法里定义的final listResult = await storageRef.listAll()是局部变量，和外层类成员完全无关，FutureBuilder绑定未初始化的late变量时直接触发报错。
• 生命周期方法用法错误：initState不能直接用async/await，Flutter框架不会等待initState内的异步逻辑执行完成再触发首次build，等异步方法跑完时第一帧已经渲染过了。
• 类型不匹配：getFolders()定义的返回值是Future<List<String>>，但FutureBuilder指定的泛型是List<FirebaseFolder>，两边类型完全不匹配；另外FirebaseFolder模型要求必填ref和url字段，但你只存储了文件夹名字符串，后续要操作文件夹引用时会直接报错。
• 数据源不一致：ListView的itemCount用的是folderYear.length，但列表项构造时取的是folders列表的数据，两个列表长度不一时会触发数组越界；同时你往folderYear里添加数据后没有调用setState，就算异步拉取完成页面也不会刷新。
• 异常场景缺失：FutureBuilder只处理了加载中状态，没有处理请求失败、数据为空的场景，容易触发空指针。

核心调整逻辑：直接在initState中给listResult赋值异步方法返回的Future实例，由FutureBuilder自动监听异步状态；统一数据源，所有渲染数据从Future快照中获取，去掉冗余的folderYear列表；补全错误、空数据状态处理。

首先修正模型类，Cloud Storage的文件夹本身没有下载url，将url设为可选参数：

class FirebaseFolder {
  final Reference ref;
  final String name;
  final String? url;

  const FirebaseFolder({
    required this.ref,
    required this.name,
    this.url,
  });
}

修正后的DashBoard页面代码：

class DashBoard extends StatefulWidget {
  const DashBoard({Key? key}) : super(key: key);

  @override
  State<DashBoard> createState() => _DashBoardState();
}

class _DashBoardState extends State<DashBoard> {
  late Future<List<FirebaseFolder>> listResult;

  @override
  void initState() {
    super.initState();
    // 直接赋值异步方法返回的Future实例，不要在initState中await阻塞
    listResult = getFolders();
  }

  Future<List<FirebaseFolder>> getFolders() async {
    final storageRef = FirebaseStorage.instance.ref().child("front end");
    final storageListResult = await storageRef.listAll();
    // 遍历文件夹前缀直接转成模型对象返回
    return storageListResult.prefixes.map((prefix) {
      return FirebaseFolder(
        ref: prefix,
        name: prefix.name,
      );
    }).toList();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      backgroundColor: Colors.white,
      appBar: kAppBar('DashBoard'),
      body: FutureBuilder<List<FirebaseFolder>>(
        future: listResult,
        builder: (context, snapshot) {
          // 加载中状态
          if (snapshot.connectionState == ConnectionState.waiting) {
            return const Center(
              child: spinkitLines,
            );
          }
          // 加载失败状态
          if (snapshot.hasError) {
            return Center(
              child: Text('文件夹加载失败：${snapshot.error}'),
            );
          }
          // 空数据状态
          final folders = snapshot.data ?? [];
          if (folders.isEmpty) {
            return const Center(
              child: Text('暂无子文件夹'),
            );
          }
          // 正常渲染列表
          return Column(
            children: [
              const SizedBox(height: 30.0),
              const Center(
                child: Text(
                  'Tap to choose semester',
                  style: kPlaceholderStyle,
                ),
              ),
              const SizedBox(height: 30),
              Expanded(
                child: ListView.builder(
                  padding: const EdgeInsets.symmetric(horizontal: 16),
                  itemCount: folders.length,
                  itemBuilder: (context, index) {
                    final folder = folders[index];
                    return Container(
                      height: 80,
                      margin: const EdgeInsets.only(bottom: 16),
                      decoration: const BoxDecoration(
                        color: Colors.black,
                        borderRadius: BorderRadius.all(Radius.circular(20)),
                        boxShadow: [
                          BoxShadow(
                              color: Color.fromARGB(75, 0, 0, 0),
                              blurRadius: 4,
                              spreadRadius: 0,
                              offset: Offset(0, 4))
                        ],
                      ),
                      child: Center(
                        child: Padding(
                          padding: const EdgeInsets.all(5.0),
                          child: Text(
                            folder.name,
                            style: kCardTitleStyle,
                          ),
                        ),
                      ),
                    );
                  },
                ),
              )
            ],
          );
        },
      ),
    );
  }
}

• listAll()方法单次最多拉取1000个存储项，如果父文件夹下子项超过这个数量，需要改用list()方法做分页拉取，避免数据拉取不全。
• 不要给late修饰的Future变量在异步回调中赋值，否则大概率出现build执行时变量未初始化的问题，直接在initState中把异步函数返回的Future实例赋值给变量即可。
• 同源数据只维护一份即可，不要同时维护多个列表存储相同信息，避免数据不同步导致的渲染异常。

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