Flutter开发：Android平台如何实现返回键不可关闭的对话框

• showDialog 本质是向应用路由栈推入一个独立的DialogRoute对象，作为栈顶路由存在
• Android系统返回键的事件拦截逻辑，是从栈顶到栈底逐路由匹配处理的：只有当前栈顶路由的拦截逻辑没有拦下返回动作，事件才会向下层路由传递
• 若将WillPopScope套在主页Scaffold外层，对话框作为栈顶路由时，返回键事件首先由Dialog路由自身处理：barrierDismissible仅控制点击对话框外部遮罩的关闭行为，对返回键的默认处理逻辑是直接pop关闭对话框，事件根本不会冒泡到下层主页的WillPopScope，因此onWillPop回调永远不会触发

将返回键拦截的WillPopScope直接包裹在对话框的构建逻辑上，不依赖外层页面的拦截能力：

改动说明 #

• 保留外层主页原有WillPopScope逻辑，继续处理无对话框弹出时的主页返回拦截
• 在showDialog的builder返回的组件外层包裹WillPopScope，直接拦截当前对话框路由的返回事件
• 对话框内部调用pop时，使用builder传入的对话框专属context，避免context不匹配问题

代码修改示例 #

原showDialog逻辑：

await showDialog(
  context: context,
  barrierDismissible: false,
  builder: (BuildContext context) => OneActionDialog(
    title: "Location Settings",
    child: Text("Click OK to goto settings"),
    btnTitle: "OK",
    action: () {
      widget.setIsLocationWarningActive(false);
      _isCheckingLocation = false;
      SystemSetting.goto(SettingTarget.LOCATION);
      Navigator.of(context).pop(true);
    },
  ),
);

修改后：

await showDialog(
  context: context,
  barrierDismissible: false,
  builder: (BuildContext dialogContext) => WillPopScope(
    onWillPop: () async {
      // 返回false拦截返回动作，禁止通过系统返回键关闭对话框
      // 如有特定业务判断需要允许关闭，按逻辑返回对应布尔值即可
      return false;
    },
    child: OneActionDialog(
      title: "Location Settings",
      child: Text("Click OK to goto settings"),
      btnTitle: "OK",
      action: () {
        widget.setIsLocationWarningActive(false);
        _isCheckingLocation = false;
        SystemSetting.goto(SettingTarget.LOCATION);
        Navigator.of(dialogContext).pop(true);
      },
    ),
  ),
);

注意：builder 传入的context是对话框路由自身的上下文，和外层页面的context分属不同的路由层级，操作对话框关闭动作时必须使用这个专属context，否则会出现pop操作对应路由错误的问题。

• barrierDismissible = false 阻止点击遮罩关闭对话框
• 对话框层级的WillPopScope拦截返回键事件，返回false时不会响应系统返回键的关闭动作
• 完全符合“非用户主动点击按钮不允许关闭对话框”的业务要求

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