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
相关产品推荐
相关产品推荐

