Flutter模拟器中Firebase数据加载异常：文档越多加载越慢甚至失败

在Android Studio模拟器中开发Flutter应用时，从Firebase Firestore多个集合读取数据遇到以下问题：

• 含1个文档的集合能立即加载显示
• 含2个文档的集合加载速度明显变慢
• 含5个文档的集合完全无法加载
  所有文档的字段数量一致，且使用同一套数据获取与展示逻辑。当前代码存在RangeError（未检查currentIndex的有效范围），但推测这不是加载失败的核心原因——因为对应5个文档的biology集合连第一个问题都无法显示。

相关代码 #

import 'package:flutter/material.dart';
import 'package:cloud_firestore/cloud_firestore.dart';
import 'package:firebase_core/firebase_core.dart';
import './questions.dart';

class QuizPage extends Stateful Widget {

  final String subjectHolder;

  const QuizPage(this.subjectHolder, {Key? key}) : super(key: key);

  @override
  State<QuizPage> createState() => _QuizPageState();
}

class _QuizPageState extends State<QuizPage> {

  String subject = 'biology';

  @override
  void initState(){
    subject = widget.subjectHolder;   
    super.initState();
  }

  Stream<List<Question>> readQuestions() => 
  FirebaseFirestore.instance.collection(subject).snapshots()
  .map((snapshot) => snapshot.docs.map((doc) => Question.fromJson(doc.data())).toList());

  var currentIndex = 0;

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: StreamBuilder<List<Question>>(
        stream: readQuestions(),
        builder: (context, snapshot) {
          if (snapshot.hasData) {
            final questions = snapshot.data!;
            return Center(
              child: Column(children: [
                Text("${questions[currentIndex].question}"),
                ElevatedButton(onPressed: () {
                  setState(() {
                    currentIndex +=1;
                  });
                }, 
                child: Text("${questions[currentIndex].option_a}")),
                ElevatedButton(onPressed: () {
                  setState(() {
                    currentIndex +=1;
                  });
                }, 
                child: Text("${questions[currentIndex].option_b}")),
                ElevatedButton(onPressed: () {
                  setState(() {
                    currentIndex +=1;
                  });
                }, 
                child: Text("${questions[currentIndex].option_c}")),
              ]
              ),
            );
          }
          else {
            return Center(child: CircularProgressIndicator());
          }
        }),
    );
  }
}

排查与修复方案 #

1. 先添加错误捕获，明确加载失败原因 #

当前代码只处理了snapshot.hasData的情况，完全忽略了加载错误。修改StreamBuilder的builder逻辑，先捕获错误：

builder: (context, snapshot) {
  // 先处理错误情况
  if (snapshot.hasError) {
    return Center(child: Text('加载失败: ${snapshot.error}'));
  }
  
  if (snapshot.hasData) {
    // 原有展示逻辑
  } else {
    return Center(child: CircularProgressIndicator());
  }
}

这样能直接看到Firestore返回的具体错误，比如权限被拒、字段解析失败、网络异常等，是排查问题的关键第一步。

2. 验证Question.fromJson的字段映射正确性 #

如果Question.fromJson函数中存在字段名不匹配（比如Firestore文档里是optionA，代码里写的是option_a），当文档数量增多时，解析失败会导致Stream无法正常输出数据，最终表现为加载卡住。检查questions.dart中的实现，确保所有字段严格对应：

// 示例正确实现
class Question {
  final String question;
  final String option_a;
  final String option_b;
  final String option_c;

  Question({
    required this.question,
    required this.option_a,
    required this.option_b,
    required this.option_c,
  });

  factory Question.fromJson(Map<String, dynamic> json) {
    return Question(
      question: json['question'] as String,
      option_a: json['option_a'] as String,
      option_b: json['option_b'] as String,
      option_c: json['option_c'] as String,
    );
  }
}

3. 避免重复创建Stream #

当前readQuestions()在每次Widget build时都会重新创建Stream，导致重复发起Firestore请求，可能引发加载异常。将Stream缓存到initState中：

late final Stream<List<Question>> questionsStream;

@override
void initState(){
  super.initState();
  subject = widget.subjectHolder;
  // 只在初始化时创建一次Stream
  questionsStream = FirebaseFirestore.instance.collection(subject).snapshots()
      .map((snapshot) => snapshot.docs.map((doc) => Question.fromJson(doc.data())).toList());
}

然后在StreamBuilder中使用questionsStream替代readQuestions()。

4. 检查Firestore权限规则 #

如果权限规则限制了读取文档的数量，或者未授权读取，会导致多文档集合加载失败。测试阶段可以临时调整规则（上线前务必改回安全规则）：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /{document=**} {
      allow read, write: if true; // 临时开放权限，仅用于测试
    }
  }
}

5. 排除模拟器网络问题 #

Android模拟器偶尔会出现网络不稳定，尝试：

• 重启模拟器
• 切换模拟器网络模式（如从Wi-Fi切换到LTE）
• 直接在真机上测试，验证是否是模拟器本身的问题

6. 修复RangeError（避免后续崩溃） #

虽然你认为这不是当前加载问题的原因，但仍需处理索引越界问题，防止后续操作崩溃：

if (snapshot.hasData) {
  final questions = snapshot.data!;
  // 先检查索引是否有效
  if (currentIndex >= questions.length) {
    return Center(child: Text('已完成所有题目'));
  }
  // 原有展示逻辑
}

同时修改按钮点击逻辑：

ElevatedButton(onPressed: () {
  setState(() {
    if (currentIndex < questions.length - 1) {
      currentIndex += 1;
    }
  });
}, child: Text("${questions[currentIndex].option_a}")),

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