Flutter报错求助：TextEditingController赋值结合ValueListenableBuilder触发异常

核心原因 #

错误本质是Widget构建流程未完成时，触发了新的重绘请求——给TextEditingController赋值后，页面顶部的ValueListenableBuilder会监听其变化并触发build，而此时当前页面的初始build还在进行中，导致断言冲突。

方案1：用WidgetsBinding延迟赋值 #

把赋值逻辑放到当前build完成后执行，彻底避开构建流程中的重绘冲突：

// 获取到其他页面选中的值后执行
WidgetsBinding.instance.addPostFrameCallback((_) {
  targetTextEditingController.text = selectedValue;
});

方案2：给ValueListenableBuilder加初始判断 #

在builder方法里过滤初始构建阶段的无效触发，避免不必要的重绘：

ValueListenableBuilder<TextEditingValue>(
  valueListenable: targetTextEditingController,
  builder: (context, value, child) {
    // 未获取到选中值时，直接返回初始TextField
    if (!hasGotSelectedValue) {
      return TextField(controller: targetTextEditingController);
    }
    return TextField(
      controller: targetTextEditingController,
      // 其他配置项
    );
  },
)

其中hasGotSelectedValue是一个状态变量，标记是否已从其他页面拿到选中值。

方案3：用Future.delayed简易延迟赋值 #

如果场景简单，可通过最小延迟把赋值放到事件循环下一轮，避开当前build：

Future.delayed(Duration.zero, () {
  targetTextEditingController.text = selectedValue;
});

方案4：拆分状态管理逻辑 #

将选中值的状态抽离到独立状态类，让ValueListenableBuilder监听状态类而非直接监听控制器，精准控制重绘时机：

class SelectionState extends ChangeNotifier {
  String? _selectedVal;
  String? get selectedVal => _selectedVal;

  void updateVal(String val) {
    _selectedVal = val;
    notifyListeners();
  }
}

// 页面中使用
ValueListenableBuilder<SelectionState>(
  valueListenable: selectionState,
  builder: (context, state, child) {
    if (state.selectedVal != null) {
      targetTextEditingController.text = state.selectedVal!;
    }
    return TextField(controller: targetTextEditingController);
  },
)

注意要确保赋值操作仅执行一次，避免重复触发重绘。

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