You need to enable JavaScript to run this app. Flutter:修复FutureBuilder中setState报错,实现ExpansionTile的Future单次加载
优惠活动
大模型
产品
解决方案
定价
更多

Flutter:修复FutureBuilder中setState报错,实现ExpansionTile的Future单次加载

报错根因

当前异常的直接触发原因是:在FutureBuilder的builder回调内部直接调用setState()。builder是Widget构建流程的核心组成部分,在构建流程未完成时触发自身重建请求,必然被Flutter框架拦截抛出异常。
现有实现同时存在两个和需求不匹配的问题:

  • 每次构建到对应分支时都会重新创建新的Future实例,哪怕之前已经发起过请求也会重复执行数据库操作
  • 状态修改逻辑和UI构建逻辑完全耦合在builder中,流程边界混乱
匹配需求的修复方案

核心逻辑对齐:将数据加载流程从Widget构建阶段抽离,仅在折叠面板首次展开时发起一次数据请求,加载完成的结果持久存储在State成员中,后续折叠/展开操作不重复触发请求。
具体调整点:

  • 将待执行的Future实例、加载完成的Trim数据统一存为State成员变量,避免构建时重复创建Future对象
  • 将Future的触发逻辑迁移到ExpansionTile的onExpansionChanged回调中,仅在首次展开、未发起过请求时执行数据库查询
  • 移除FutureBuilder的builder内所有状态修改逻辑,builder仅负责根据当前加载状态渲染对应UI
  • 将状态更新逻辑放到Future的异步回调中执行,确保状态修改发生在构建流程结束之后
调整后的核心代码片段
class _DashboardState extends State<Dashboard> with AutomaticKeepAliveClientMixin<Dashboard> {
  @override
  bool get wantKeepAlive => true;

  Boat selectedBoat = Hive.box("selections").get("selectedBoat");
  bool latestTrimExpanded = false;

  // 最新调校数据,仅加载一次
  Trim? latestTrim;
  DateTime? date;
  DateFormat dateFormat = DateFormat("dd.MM.yyyy");
  DateFormat timeFormat = DateFormat("HH:mm");
  double? satisfaction;
  IconData? icon;
  Color? color;
  Map<String, dynamic> trimOptions = {};
  // 新增:存储已发起的请求实例,避免重复创建
  Future<Trim>? _latestTrimFuture;

  @override
  Widget build(BuildContext context) {
    return Background(
      pageViewScrollNotifier: widget.pageViewScrollNotifier,
      pageViewIndexNotifier: widget.pageViewIndexNotifier,
      pageViewIndex: widget.pageViewIndex,
      child: ListView(
        shrinkWrap: true,
        physics: const NeverScrollableScrollPhysics(),
        children: [
          selectedBoat != null
              ? CustomCard(
                  child: Column(
                    mainAxisAlignment: MainAxisAlignment.start,
                    mainAxisSize: MainAxisSize.min,
                    crossAxisAlignment: CrossAxisAlignment.start,
                    children: [
                      Theme(
                        data: Theme.of(context).copyWith(dividerColor: Colors.transparent),
                        child: ExpansionTile(
                          leading: Icon(
                            FlutterIcons.settings_oct,
                            size: 30,
                            color: Color(Hive.box("configs").get("colors")["black"]),
                          ),
                          title: Text(
                            AppLocalizations.of(context).translate("trims.latestTrim"),
                            style: Theme.of(context).textTheme.headline2
                          ),
                          maintainState: true,
                          onExpansionChanged: (value) {
                            setState(() {
                              latestTrimExpanded = value;
                            });
                            // 仅在首次展开、未加载过数据、未发起过请求时触发加载
                            if (value && latestTrim == null && _latestTrimFuture == null) {
                              _latestTrimFuture = DatabaseInstance.trim.getLatestTimeOfBoat(selectedBoat.documentid);
                              // 异步回调中更新状态,不侵入构建流程
                              _latestTrimFuture!.then((trimData) {
                                setState(() {
                                  latestTrim = trimData;
                                  date = latestTrim!.time["ts"].first;
                                  satisfaction = latestTrim!.evaluation["satisfaction"].first;
                                  icon = satisfactionIcon(satisfaction!);
                                  color = satisfactionColor(satisfaction);
                                  Hive.box("configs").get("boatClasses")[
                                      Hive.box("selections").get("selectedBoat").boatClass
                                  ]["trimTemplate"].forEach((key, value) {
                                    if (!trimOptions.containsKey(key)) {
                                      trimOptions[key] = value;
                                    }
                                  });
                                });
                              });
                            }
                          },
                        ),
                      ),
                      // 展开时根据加载状态渲染对应UI
                      if (latestTrimExpanded)
                        latestTrim == null
                            ? FutureBuilder(
                                // 绑定已存储的Future实例,不会重复触发请求
                                future: _latestTrimFuture,
                                builder: (context, snapshot) {
                                  if (snapshot.connectionState != ConnectionState.done) {
                                    return StandardLoading();
                                  }
                                  // 数据已在异步回调中存入State,直接渲染即可
                                  return const SizedBox();
                                },
                              )
                            : const SizedBox(),
                    ],
                  ),
                )
              : Container(),
        ],
      ),
    );
  }
}
方案效果说明
  • 彻底消除构建阶段调用setState()的异常:所有状态修改都发生在异步回调中,完全脱离Widget构建流程
  • 满足单次加载需求:请求实例和结果都存在State成员中,折叠面板关闭后再次展开时,由于latestTrim已经有值,不会重复发起数据库请求
  • 适配现有保活逻辑:结合已经实现的AutomaticKeepAliveClientMixin,State在Tab切换时不会被销毁,跨页面返回也不会重复加载数据

内容的提问来源于stack exchange,提问作者Florian

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.03 21:45:04