Flutter如何实现页面加载完成后无操作自动调用showDialog弹窗

直接在initState生命周期中调用showDialog报错，核心原因是initState执行时，当前页面组件还未完成首次渲染挂载，传入的context尚未完全接入Flutter组件树。而showDialog需要依赖已挂载的上下文查找导航栈相关的组件依赖，此时调用必然抛出上下文未挂载的异常。

方案1：首帧渲染完成后触发弹窗（适配页面加载后自动弹出的需求） #

Flutter提供了帧绘制回调方法，可以精准监听页面首次渲染完成的时机，在回调中触发弹窗就不会出现上下文未挂载的问题。
首先在_BodyState类中增加弹窗标记位，避免组件重建时重复弹窗：

class _BodyState extends State<Body> {
  bool isMapList = false;
  // 增加弹窗标记，避免重复弹出
  bool _hasShownEmailDialog = false;

  // 其余原有代码保持不变
}

然后重写initState方法，在首帧回调中执行弹窗逻辑：

@override
void initState() {
  super.initState();
  // 注册首帧绘制完成回调
  WidgetsBinding.instance.addPostFrameCallback((_) {
    // 先判断组件是否仍挂载、弹窗是否已展示，避免异常和重复弹出
    if (mounted && !_hasShownEmailDialog) {
      _hasShownEmailDialog = true;
      showDialog(
        context: context,
        builder: (BuildContext context) => const SendEmailDialog(),
      );
    }
  });
}

方案2：基于Bloc业务状态触发弹窗（适配状态驱动场景） #

如果你的弹窗不是每次进入页面都弹出，而是依赖接口返回、权限校验等Bloc管理的业务状态触发，不要在BlocBuilder的构建方法中直接调用弹窗，优先使用BlocListener处理弹窗、路由跳转这类副作用逻辑：

@override
Widget build(BuildContext context) {
  final Size size = MediaQuery.of(context).size;
  final double paddingTop = MediaQuery.of(context).padding.top;
  // 外层套BlocListener处理副作用
  return BlocListener<YourAuthCubit, YourAuthState>(
    listener: (context, state) {
      // 满足弹窗触发条件时执行，比如需要验证邮箱的状态
      if (state is NeedVerifyEmailState && mounted && !_hasShownEmailDialog) {
        _hasShownEmailDialog = true;
        // 保险起见也可以搭配addPostFrameCallback，避免状态在构建过程中触发
        WidgetsBinding.instance.addPostFrameCallback((_) {
          showDialog(
            context: context,
            builder: (BuildContext context) => const SendEmailDialog(),
          );
        });
      }
    },
    child: BlocBuilder<StationCubit, StationState>(
      builder: (context, state) {
        final StationCubit cubit = BlocProvider.of<StationCubit>(context);
        return BlocBuilder<StationMarkerCubit, StationMarkerState>(
          builder: (context, stationMarkerState) {
            final StationMarkerCubit stationMarkerCubit =
                BlocProvider.of<StationMarkerCubit>(context);
            // 原有Container及后续布局代码保持不变
            return Container(
              height: size.height,
              width: size.width,
              decoration: isMapList
                  ? const BoxDecoration(
                      gradient: LinearGradient(
                        begin: Alignment.topCenter,
                        end: Alignment.bottomCenter,
                        colors: [
                          constants.Colors.blue7xDark,
                          constants.Colors.blue6xDark,
                          constants.Colors.blueXxxxxDark,
                        ],
                      ),
                    )
                  : const BoxDecoration(
                      image: DecorationImage(
                        image: AssetImage(
                            'assets/images/background/main_background.png'),
                        fit: BoxFit.cover,
                      ),
                    ),
              child:
                  _child(context, size, cubit, stationMarkerCubit, paddingTop),
            );
          },
        );
      },
    ),
  );
}

• 不要在initState中直接同步调用任何依赖context的操作，包括弹窗、页面跳转、获取MediaQuery/Theme上下文数据等，这类操作都需要等组件完成挂载后再执行
• 所有异步回调中触发弹窗、路由跳转操作前，必须先判断mounted属性为true，避免页面已销毁时执行操作引发内存泄漏或运行时异常
• 不要在BlocBuilder的构建方法中写弹窗、跳转这类副作用逻辑，BlocBuilder会随状态变化多次执行，容易导致重复触发弹窗、跳转的问题

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