Flutter中点击设备返回键时WillPopScope失效问题求助

可能的原因及修复方案 #

1. 处理Drawer打开状态的返回拦截 #

当Drawer处于打开状态时，设备返回键默认会优先关闭Drawer，不会触发WillPopScope。需要先判断Drawer状态，再执行对应逻辑：

bool _isDrawerOpen = false;

Widget getBackgroundWidget() {
    return WillPopScope(
      onWillPop: _onBackPressed,
      child: Scaffold(
        key: scaffoldKey,
        backgroundColor: Colors.white,
        drawer: AppNavigationDrawer(onSelectMenuItem),
        // 监听Drawer开关状态
        onDrawerChanged: (isOpen) => _isDrawerOpen = isOpen,
        appBar: AppBar(
          elevation: 0.5,
          shadowColor: Colors.grey,
          backgroundColor: Colors.white,
          titleSpacing: 0,
          leading: IconButton(
            onPressed: () => scaffoldKey.currentState!.openDrawer(),
            icon: Image.asset('assets/img/landing/title_icon.png',
                height: 30, width: 30),
          ),
          title: Text(
            AppUtils.HOME_BOTTOM_LABEL_LIST[homeCubit!.currentIndex].toUpperCase(),
            style: TextStyle(fontFamily: 'NotoSansBold', fontSize: 20),
          ),
        ),
      ),
    );
  }

Future<bool> _onBackPressed() {
    // 如果Drawer打开，先关闭Drawer，不执行退出逻辑
    if (_isDrawerOpen) {
      scaffoldKey.currentState!.closeDrawer();
      return Future.value(false);
    }
    // 原有弹窗逻辑
    return showDialog(
      context: context,
      builder: (context) {
        return AlertDialog(
          backgroundColor: Colors.white,
          surfaceTintColor: Colors.transparent,
          title: Text(
            'Switch ION',
            style: TextStyle(fontSize: 23),
          ),
          content: Text('Do you want to exit the app'),
          actions: <Widget>[
            TextButton(
              child: Text(
                'No',
                style: TextStyle(color: AppTheme.appColors),
              ),
              onPressed: () {
                Navigator.of(context).pop(false);
              },
            ),
            TextButton(
              child: Text(
                'Yes',
                style: TextStyle(color: AppTheme.appColors),
              ),
              onPressed: () {
                Navigator.of(context).pop(true);
              },
            )
          ],
        );
      },
    ).then((value) {
      // 根据弹窗返回值执行退出操作
      if (value == true) {
        SystemNavigator.pop();
      }
      return value ?? false;
    });
  }

2. 确保页面处于路由栈顶层 #

如果当前页面是作为子组件嵌套在其他路由页面内部，而非直接push到Navigator栈的顶层，WillPopScope不会触发。需要确认该页面是通过Navigator.push等方式添加到路由栈的最上层。

3. 检查是否存在其他返回拦截组件 #

页面中的PageView、TabBarView或自定义路由拦截组件，可能会优先拦截返回事件。需要确保这些组件的返回逻辑不会覆盖WillPopScope的触发，或者在它们的拦截逻辑中兼容当前的退出确认需求。

4. 验证Context的正确性 #

WillPopScope使用的Context必须属于当前页面的BuildContext，不能是嵌套Navigator的子Context。如果页面内有多层Navigator嵌套，需要将WillPopScope包裹在最外层Navigator的层级中。

内容的提问来源于stack exchange，提问作者Nandyala Raja Pragnesh Reddy