Flutter实现启动页等待3秒跳转登录页时报setState构建中调用错误如何解决

该报错是因为你在组件的build构建流程还未完成时，就执行了路由跳转逻辑：路由跳转依赖系统顶层的Overlay组件，跳转操作会触发Overlay标记重绘，相当于在构建流程中调用了markNeedsBuild，就会触发该异常。

你只需要把跳转逻辑放在组件构建完成之后执行即可，推荐两种可行写法：

写法1（最稳妥） #

用WidgetsBinding的帧回调包裹逻辑，确保组件第一帧渲染完成后再执行延时跳转：

class SplashPage extends StatefulWidget {
  const SplashPage({super.key});

  @override
  State<SplashPage> createState() => _SplashPageState();
}

class _SplashPageState extends State<SplashPage> {
  @override
  void initState() {
    super.initState();
    WidgetsBinding.instance.addPostFrameCallback((_) {
      // 延时3秒跳转
      Future.delayed(const Duration(seconds: 3), () {
        // 跳转前判断组件是否还挂载，避免销毁后报错
        if (!mounted) return;
        Navigator.of(context).pushReplacement(
          MaterialPageRoute(builder: (context) => const LoginPage()),
        );
      });
    });
  }

  @override
  Widget build(BuildContext context) {
    // 这里写你的启动页UI布局，不要加任何跳转逻辑
    return const Scaffold(
      body: Center(child: Text('启动页')),
    );
  }
}

写法2（简化版） #

直接在initState中写延时逻辑，Future.delayed属于异步事件，会在同步构建流程完成后才执行，绝大多数场景下都能正常运行：

@override
void initState() {
  super.initState();
  Future.delayed(const Duration(seconds: 3), () {
    if (!mounted) return;
    Navigator.of(context).pushReplacement(
      MaterialPageRoute(builder: (context) => const LoginPage()),
    );
  });
}

• 不要把跳转逻辑直接写在build方法中，build方法会被框架多次调用，会导致逻辑重复执行还会触发本次的构建冲突异常
• 所有涉及context操作的异步回调，都建议加mounted判断，避免组件销毁后上下文失效报错

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