Flutter通过go_router打开深度链接时触发setState构建异常

问题现象 #

• 使用go_router: ^13.0.1，仅通过深度链接打开ProfilePage时抛出setState() or markNeedsBuild() called during build错误
• 正常切换页面无报错，错误仅触发一次，后续访问ProfilePage或HomePage（二者处于NavBar的PageView中）不再报错
• 尝试在ProfilePage的initState中添加WidgetsBinding.instance.addPostFrameCallback，出现_TypeError (Null check operator used on a null value)；修复空安全后HomePage仍出现相同构建异常，无法定位根因

错误日志 #

E/flutter ( 4803): [ERROR:flutter/runtime/dart_vm_initializer.cc(41)] Unhandled Exception: setState() or markNeedsBuild() called during build.
E/flutter ( 4803): This Obx widget cannot be marked as needing to build because the framework is already in the process of building widgets. A widget can be marked as needing to be built during the build phase only if one of its ancestors is currently building. This exception is allowed because the framework builds parent widgets before children, which means a dirty descendant will always be built. Otherwise, the framework might not visit this widget during this build phase.
E/flutter ( 4803): The widget on which setState() or markNeedsBuild() was called was:
E/flutter ( 4803):   Obx
E/flutter ( 4803): The widget which was currently being built when the offending call was made was:
E/flutter ( 4803):   PopScope

根因分析 #

从错误日志和场景来看，核心原因是：

1. 深度链接打开页面时，go_router会同步完成路由跳转并触发页面树构建，此时home_controller中的switchPage方法（用于控制PageView选中页）在页面构建阶段直接修改了Observable变量（比如控制PageView索引的obs变量）
2. Obx组件依赖Observable变量，变量修改会立即触发Obx重建，但此时Flutter框架正处于整体构建流程中（PopScope组件还在构建），导致重建操作与当前构建流程冲突
3. 正常切换页面时，操作是在构建完成后触发的（比如点击NavBar按钮），不会触发冲突；首次触发后状态已稳定，后续访问也不会报错

解决方案 #

方案1：延迟修改Observable变量到构建完成后 #

在switchPage方法中，用WidgetsBinding.instance.addPostFrameCallback延迟状态修改，确保当前构建周期完成后再更新：

void switchPage(int index) {
  WidgetsBinding.instance?.addPostFrameCallback((_) {
    // 修改控制PageView索引的Observable变量，例如：
    // pageIndex.value = index;
  });
}

注：使用?.处理空安全，避免出现Null check异常。

方案2：使用SchedulerBinding调度延迟任务 #

如果addPostFrameCallback仍有问题，可通过SchedulerBinding将任务调度到下一个微任务周期：

import 'package:flutter/scheduler.dart';

void switchPage(int index) {
  SchedulerBinding.instance.scheduleTask(() {
    pageIndex.value = index;
  }, Priority.postFrame);
}

方案3：调整go_router路由配置 #

确保深度链接对应的路由初始化时，不会强制同步触发PageView索引切换。可在路由的builder或redirect逻辑中，将页面切换逻辑延迟到页面挂载完成后执行。

内容的提问来源于stack exchange，提问作者Ramith K S