Flutter StatefulWidget中initState()调用Firebase.get().then()后停止执行

核心原因 #

1. 异步执行顺序问题：model!.get()是Firestore的异步操作，你用.then()注册的回调会在Firestore返回数据后才执行，但initState里的后续代码是同步执行的——也就是说，赋值控制器的逻辑会先于survey = value.data()!运行，此时survey还是初始状态（未被赋值），导致代码执行了但没有预期效果，让你误以为后续代码没执行。
2. 错误捕获范围问题：外层的try-catch无法捕获.then()内部的异步错误，因为异步错误不会冒泡到同步的try块中，所以你添加的打印语句无法捕获到异步流程里的问题。

解决方案 #

不要在initState里直接用.then()处理异步逻辑，改用async/await（注意initState本身不能是异步方法，需要单独抽一个异步方法调用），确保数据加载完成后再执行控制器赋值和状态更新逻辑，同时增加mounted判断避免widget销毁后更新状态。

修改后的代码示例 #

1. 抽取异步加载方法

Future<void> _loadSurveyData() async {
  if (widget.surveyId == "new") {
    _isLoading = false;
    if (mounted) setState(() {});
    return;
  }

  try {
    // 等待Firestore返回数据
    final value = await model!.get();
    survey = value.data()!;

    // 数据获取完成后再执行控制器赋值
    _nameController.text = survey.name ?? '';
    _ssnController.text = survey.ssn ?? '';
    _dobController.text = survey.dob ?? '';
    _dobDate = survey.dobDT;
    _livingSituation = survey.livingSituation;
    _situationChoose = survey.livingSituation ?? livingSituationList[0];
    _onLivingSituationItemSelected(_livingSituation);
    _ageController.text = survey.age ?? '';
    print(jsonEncode(_livingSituation));
    print(jsonEncode(_situationChoose));
  } catch (error) {
    print(error);
    if (mounted) {
      ScaffoldMessenger.of(context).clearSnackBars();
      ScaffoldMessenger.of(context).showSnackBar(
        SnackBar(
          content: const Text(
              'An error occured. Please try again later and check your internet connection.'),
          backgroundColor: Theme.of(context).colorScheme.error,
        ),
      );
    }
  } finally {
    // 无论成功失败，都结束加载状态
    _isLoading = false;
    if (mounted) setState(() {});
  }
}

2. 更新initState方法

@override
void initState() {
  super.initState();
  _isLoading = true;
  surveyId = widget.surveyId != "new" ? widget.surveyId : null;
  _situationChoose = livingSituationList[0];
  _ssnFocusNode.addListener(_ssnOnFocusChange);
  _dobController.addListener(_ageCalculator);
  print('Survey ID: $surveyId');
  model = _firestore
      .collection('surveys')
      .doc(widget.surveyId == "new" ? null : widget.surveyId)
      .withConverter<SurveyItem>(fromFirestore: (snapshot, _) {
    print('from Firestore called');
    final data = snapshot.data();
    if (data != null) {
      return SurveyItem.fromMap(data);
    } else {
      print('data is null');
      return SurveyItem(); // 返回默认对象避免空指针
    }
  }, toFirestore: (SurveyItem survey, _) {
    print('to Firestore called');
    return survey.toMap();
  });

  // 调用异步加载方法
  _loadSurveyData();
}

关键优化点 #

• 把控制器赋值逻辑放到异步方法中，确保只有在survey数据加载完成后才执行，保证拿到正确数据。
• 使用finally块确保无论加载成功或失败，都会结束加载状态，避免界面一直处于加载中。
• 每次更新状态前检查mounted，防止widget已销毁时调用setState引发异常。

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