Flutter子页面WillPopScope不生效，点击返回键无法设置布尔值

我创建了两个组件，希望点击返回键时切换组件状态（类似TextField的逻辑），但子页面（SearchScreen）的onWillPop没有触发调试打印，功能完全无效。目前主页面的返回键处理逻辑对所有页面生效，但我没法在子页面单独用WillPopScope实现自定义返回逻辑，只能在MainScreen统一处理。

相关代码 #

SearchScreen代码 #

bool change = true;
bool onText = false; // 补充缺失的变量定义

Future<bool> _FuturePop() async {
  if (onText) {
    FocusScope.of(context).unfocus();
    debugPrint("if onText => $onText");
    onText = false;
    return false;
  } else {
    debugPrint("else onText => $onText");
    return true;
  }
}

@override
Widget build(BuildContext context) {
  debugPrint("onText => $onText");
  return WillPopScope(
    onWillPop: _FuturePop,
    child: Scaffold(
      backgroundColor: const Color(0xffEFF4F3),
      body: SafeArea(
        child: Column(
          children: [
            const SpacerEmpty(),
            Padding(
              padding: const EdgeInsets.fromLTRB(12, 0, 12, 0),
              child: Stack(
                children: [
                  SizedBox(
                    height: 36,
                    child: Flexible(
                        child: TextField(
                      onTap: () {
                        setState(() {
                          onText = true;
                          debugPrint("onTap => $onText");
                        });
                      },
                      textInputAction: TextInputAction.done,
                      onEditingComplete: () {
                        onText = false;
                        debugPrint("onEdCpm => $onText");
                        FocusScope.of(context).unfocus();
                      },
                      decoration: const InputDecoration(
                          fillColor: Colors.white,
                          floatingLabelBehavior: FloatingLabelBehavior.never,
                          contentPadding:
                              EdgeInsets.only(bottom: 8, right: 8),
                          border: OutlineInputBorder(
                              borderRadius:
                                  BorderRadius.all(Radius.circular(12)),
                              borderSide: BorderSide(
                                  width: .5, color: Color(0xaaacacac)))),
                    )),
                  ),
                  const Positioned(
                      left: 8,
                      top: 0,
                      bottom: 0,
                      child: Icon(CupertinoIcons.search)),
                ],
              ),
            ),
            // 剩余组件省略
          ],
        ),
      ),
    ),
  );
}

MainScreen核心代码 #

Future<bool> _onWillPop() async {
  if (_scaffoldKey.currentState!.isDrawerOpen) {
    _scaffoldKey.currentState!.closeDrawer();
    return false;
  } else if (selectedScreenIndex == homeIndex) {
    if (doubleTapedToExit) {
      return true;
    } else {
      doubleTapedToExit = true;
      ShowToast(message: 'برای خروج از برنامه دو بار دکمه بازگشت را بزنید.');
      Future.delayed(const Duration(seconds: 2)).then((value) {
        doubleTapedToExit = false;
      });
      return false;
    }
  }

  final NavigatorState currentSelectedTabNavigatorState =
      map[selectedScreenIndex]!.currentState!;
  if (currentSelectedTabNavigatorState.canPop()) {
    currentSelectedTabNavigatorState.pop();
    return false;
  } else if (_history.isNotEmpty) {
    setState(() {
      selectedScreenIndex = homeIndex;
      _history.clear();
    });
    return false;
  }

  return true;
}

@override
Widget build(BuildContext context) {
  return WillPopScope(
    onWillPop: _onWillPop,
    child: SafeArea(
      child: Scaffold(
        key: _scaffoldKey,
        resizeToAvoidBottomInset: false,
        drawer: Drawer(/* 抽屉组件省略 */),
        body: Stack(
          children: [
            Positioned.fill(
              bottom: 0,
              child: IndexedStack(
                index: selectedScreenIndex,
                children: [
                  _navigator(_homeKey, homeIndex, const HomeScreen()),
                  _navigator(_searchKey, searchIndex, const SearchScreen()),
                  // 其他Tab页面省略
                ],
              ),
            ),
            // 顶部Toolbar和底部导航栏省略
          ],
        ),
      ),
    ),
  );
}

原因分析 #

主页面的WillPopScope是应用的顶层返回事件拦截器，它的_onWillPop方法在大多数场景下返回false（阻止默认返回行为），导致返回事件根本不会向下传递到子页面的WillPopScope，所以子页面的自定义逻辑完全无法触发。

解决方案 #

需要修改主页面的_onWillPop方法，先让当前选中Tab的子页面优先处理返回事件，再执行全局逻辑。

步骤1：修改SearchScreen，移除内部WillPopScope并暴露自定义返回方法 #

class SearchScreen extends StatefulWidget {
  const SearchScreen({Key? key}) : super(key: key);

  @override
  State<SearchScreen> createState() => _SearchScreenState();
}

class _SearchScreenState extends State<SearchScreen> {
  bool onText = false;

  // 暴露给主页面调用的自定义返回逻辑
  Future<bool> handleBackPress() async {
    if (onText) {
      FocusScope.of(context).unfocus();
      debugPrint("if onText => $onText");
      setState(() => onText = false);
      return false; // 阻止返回
    } else {
      debugPrint("else onText => $onText");
      return true; // 允许返回
    }
  }

  @override
  Widget build(BuildContext context) {
    debugPrint("onText => $onText");
    // 移除外层WillPopScope
    return Scaffold(
      backgroundColor: const Color(0xffEFF4F3),
      body: SafeArea(
        child: Column(
          children: [
            const SpacerEmpty(),
            // TextField部分代码保持不变
            // 剩余组件省略
          ],
        ),
      ),
    );
  }
}

步骤2：修改MainScreen的_onWillPop方法，优先调用子页面的自定义逻辑 #

Future<bool> _onWillPop() async {
  // 1. 处理抽屉逻辑
  if (_scaffoldKey.currentState!.isDrawerOpen) {
    _scaffoldKey.currentState!.closeDrawer();
    return false;
  }

  // 2. 优先处理当前Tab子页面的自定义返回逻辑
  if (selectedScreenIndex == searchIndex) {
    // 获取SearchScreen的State对象
    final searchState = _searchKey.currentState?.context.findAncestorStateOfType<_SearchScreenState>();
    if (searchState != null) {
      bool shouldPop = await searchState.handleBackPress();
      if (!shouldPop) {
        // 子页面阻止返回，直接结束流程
        return false;
      }
    }
  }

  // 3. 处理子Navigator的栈返回逻辑
  final NavigatorState currentSelectedTabNavigatorState =
      map[selectedScreenIndex]!.currentState!;
  if (currentSelectedTabNavigatorState.canPop()) {
    currentSelectedTabNavigatorState.pop();
    return false;
  }

  // 4. 首页双击退出逻辑
  if (selectedScreenIndex == homeIndex) {
    if (doubleTapedToExit) {
      return true;
    } else {
      doubleTapedToExit = true;
      ShowToast(message: 'برای خروج از برنامه دو بار دکمه بازگشت را بزنید.');
      Future.delayed(const Duration(seconds: 2)).then((_) => doubleTapedToExit = false);
      return false;
    }
  }

  // 5. 历史记录返回首页
  if (_history.isNotEmpty) {
    setState(() {
      selectedScreenIndex = homeIndex;
      _history.clear();
    });
    return false;
  }

  return true;
}

关键要点 #

• 移除子页面的WillPopScope，避免与主页面的顶层拦截冲突
• 通过子页面的State对象直接调用自定义返回方法，确保逻辑优先级
• 主页面的返回拦截逻辑需要按「子页面自定义逻辑 → 子Navigator栈返回 → 全局逻辑」的顺序执行

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