Flutter如何在FutureBuilder内部调用setState避免构建阶段报错

FutureBuilder的builder方法属于Widget构建流程的一部分，此时Flutter框架正处于组件树的渲染计算阶段，禁止调用setState触发新一轮构建，否则会导致构建流程冲突，因此抛出该异常。同时你的代码还存在隐含问题：snapid.data == "Error_ID"的分支没有返回Widget，会触发返回空的异常。

• 方法1：延后到当前帧构建完成后执行状态更新
  用WidgetsBinding.instance.addPostFrameCallback包裹setState逻辑，该回调会在当前帧所有组件构建完成后触发，不会和正在执行的构建流程冲突，同时记得补全返回的Widget：

  FutureBuilder<String>(
    future: fetchIdPlayer(idPlayer, bouquet),
    builder: (context, snapid) {
      if (!snapid.hasData) {
        return Container(
          height: mobileHeight * 0.05,
          child: const Center(
            child: CircularProgressIndicator(),
          ),
        );
      } else if (snapid.data == "Error_ID") {
        WidgetsBinding.instance.addPostFrameCallback((_) {
          setState(() {
            have_ID = true;
            resultName = "رقم تعريف اللاعب خاطئ";
          });
        });
        return const SizedBox.shrink();
      }
      // 正常数据分支补全返回对应组件即可
      return 你需要展示的正常业务组件;
    })
  

• 方法2：将状态逻辑移到异步请求链路中（更推荐）
  业务逻辑不要放到视图构建的builder方法中处理，提前初始化异步请求，在请求的回调中处理状态更新，同时还能避免Future被重复调用的问题：

  // 先定义类成员变量存储Future
  late Future<String> _playerFuture;
  
  @override
  void initState() {
    super.initState();
    // 初始化时执行异步请求，提前处理逻辑
    _playerFuture = fetchIdPlayer(idPlayer, bouquet);
    _playerFuture.then((value) {
      if (value == "Error_ID") {
        setState(() {
          have_ID = true;
          resultName = "رقم تعريف اللاعب خاطئ";
        });
      }
    });
  }
  
  // FutureBuilder绑定提前初始化的Future
  FutureBuilder<String>(
    future: _playerFuture,
    builder: (context, snapid) {
      if (!snapid.hasData) {
        return Container(
          height: mobileHeight * 0.05,
          child: const Center(
            child: CircularProgressIndicator(),
          ),
        );
      } else if (snapid.data == "Error_ID") {
        return const SizedBox.shrink();
      }
      // 正常数据分支补全返回对应组件即可
      return 你需要展示的正常业务组件;
    })
  

• 方法3：直接在构建层处理状态，无需额外setState
  如果have_ID和resultName仅用于当前页面的视图展示，可以不用单独存为状态变量，直接在builder中根据snapid的状态动态渲染内容即可，减少不必要的重绘。

不要直接在FutureBuilder的future参数中直接创建Future（比如直接写future: fetchIdPlayer(idPlayer, bouquet)），否则每次父组件重绘都会重新触发异步请求，造成资源浪费。

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