Flutter Firebase报无docs实例getter错误 数据存储成功不展示

运行Flutter项目点击按钮时抛出如下报错，Firebase后端数据可正常写入存储，但页面无法正常展示已存储的数据：
Class 'List<_JsonQueryDocumentSnapshot>' has no instance getter 'docs'
相关报错截图：

• 核心报错原因：getPosts()方法的返回值本身已经是List<_JsonQueryDocumentSnapshot>类型的文档快照列表，只有Firebase返回的QuerySnapshot对象才带有.docs getter，对已经是列表结构的对象调用.docs会直接抛出找不到实例方法的错误。
• 附带逻辑问题：原代码存在页码变量作用域错误、多余map嵌套无返回值、未做加载状态判断易触发空异常等问题，即使解决类型报错也无法正常渲染列表。

// 注意：_currentPageIndex 需要定义在对应State类的顶层，不要写在builder内部
int _currentPageIndex = 0;

@override
Widget build(BuildContext context) {
  return Column(
    crossAxisAlignment: CrossAxisAlignment.start,
    children: [
      const SizedBox(height: 15),
      const Center(
        child: Text(
          "Trip",
          textAlign: TextAlign.center,
          style: TextStyle(
              fontWeight: FontWeight.bold,
              fontSize: 15,
              color: Colors.black),
        ),
      ),
      const SizedBox(height: 20),
      FutureBuilder(
          future: getPosts(),
          // 明确声明快照返回类型，避免类型推断混乱
          builder: (context, AsyncSnapshot<List<QueryDocumentSnapshot>> snapshot) {
            // 加载状态优先判断，避免未拿到数据时访问length触发空指针
            if (snapshot.connectionState == ConnectionState.waiting || !snapshot.hasData) {
              return const Center(child: Text("Loading"));
            }
            // 此时snapshot.data就是文档列表，不需要再调用.docs
            List<QueryDocumentSnapshot> tripList = snapshot.data!;
            return SizedBox(
              height: 200,
              child: PageView.builder(
                  itemCount: tripList.length,
                  onPageChanged: (int index) {
                    setState(() => _currentPageIndex = index);
                  },
                  itemBuilder: (_, i) {
                    Map<String, dynamic> tripData = tripList[i].data() as Map<String, dynamic>;
                    return ListTile(
                      // 增加空兜底，避免字段缺失报错
                      title: Text(tripData['tripname'] ?? '未命名行程'),
                    );
                  }),
            );
          }),
    ],
  );
}

• 删除所有snapshot.data.docs的错误调用，直接使用snapshot.data作为文档列表遍历
• 为FutureBuilder补充明确的泛型声明，指定返回类型为文档快照列表，从根源避免类型调用错误
• 将页码记录变量移至State类顶层，原写法将变量定义在map内部，每次重建都会重置变量，无法正常记录页码状态
• 移除无意义的.map()嵌套，原写法在map中创建PageView但未返回组件，属于无效逻辑
• 补充加载状态判断和字段空值兜底，避免数据未返回、字段缺失场景下的崩溃问题
• 用SizedBox替代固定高度的Container，减少不必要的组件性能开销

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