Flutter中Navigator.pushNamed引发build期setState调用错误求助

错误根源 #

你遇到的setState() or markNeedsBuild() called during build错误，核心原因是在组件构建阶段就执行了导航代码。看你的RoundedButton实现，MaterialButton的onPressed属性写的是onPress()——带括号的写法会直接调用这个函数，而不是把函数作为点击回调传递。这导致Navigator.pushNamed在RoundedButton的build方法执行时就被触发，而此时组件还在构建流程中，导航操作会触发页面状态更新，从而引发断言错误。

修复步骤 #

1. 修正RoundedButton的函数类型与回调传递

首先修改RoundedButton的代码：

• 将onPress的类型从Function改为更精准的VoidCallback（Flutter中按钮点击回调的标准类型，等价于Function()）
• 将MaterialButton的onPressed改为直接传递onPress（不带括号），这样才是把函数作为点击事件的回调，而非立即执行

修改后的RoundedButton代码：

class RoundedButton extends StatelessWidget {
  RoundedButton({
    required this.buttonColor,
    required this.buttonText,
    required this.onPress,
  });

  final Color buttonColor;
  final String buttonText;
  final VoidCallback onPress; // 改为VoidCallback类型

  @override
  Widget build(BuildContext context) {
    return Padding(
      padding: EdgeInsets.symmetric(vertical: 16.0),
      child: Material(
        elevation: 5.0,
        color: buttonColor,
        borderRadius: BorderRadius.circular(30.0),
        child: MaterialButton(
          onPressed: onPress, // 移除括号，传递函数引用
          minWidth: 200.0,
          height: 42.0,
          child: Text(
            buttonText,
            style: TextStyle(color: Colors.white),
          ),
        ),
      ),
    );
  }
}

2. 保持调用处的代码不变

你原来传入匿名函数的写法是正确的，不需要修改：

RoundedButton(
  buttonColor: Colors.lightBlueAccent,
  buttonText: 'Log In',
  onPress: () {
    Navigator.pushNamed(context, LoginScreen.id);
  },
),

为什么这样能解决问题 #

修改后，onPress函数只会在用户点击按钮时才被执行，此时组件已经完成构建流程，导航操作不会干扰构建过程，自然不会触发setState() or markNeedsBuild()的错误。

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