Flutter中TextFormField点击返回键返回页面而非收起键盘问题

当页面存在上级路由时，系统返回事件会优先触发页面回退，而非默认收起键盘——这就是你遇到的问题核心。下面是两种可靠的解决方式：

方案一：全局判断焦点，通用拦截 #

通过FocusManager检查当前是否有输入框处于聚焦状态，优先收起键盘再决定是否允许页面返回。如果之前用WillPopScope没生效，大概率是拦截逻辑没写对：

@override
Widget build(BuildContext context) {
  return WillPopScope(
    onWillPop: () async {
      // 检查是否存在聚焦的输入框
      final hasFocus = FocusManager.instance.primaryFocus?.hasFocus ?? false;
      if (hasFocus) {
        // 收起键盘
        FocusManager.instance.primaryFocus?.unfocus();
        // 阻止页面返回
        return false;
      }
      // 无聚焦输入框时，允许返回上一页
      return true;
    },
    child: Scaffold(
      body: YourCustomTextFormField(), // 你的自定义输入框组件
    ),
  );
}

方案二：绑定单个输入框的焦点节点 #

如果需要精准控制特定的自定义TextFormField，可以给组件绑定专属的FocusNode：

final FocusNode _customFieldFocus = FocusNode();

@override
void dispose() {
  // 记得释放焦点节点，避免内存泄漏
  _customFieldFocus.dispose();
  super.dispose();
}

@override
Widget build(BuildContext context) {
  return WillPopScope(
    onWillPop: () async {
      if (_customFieldFocus.hasFocus) {
        _customFieldFocus.unfocus();
        return false;
      }
      return true;
    },
    child: Scaffold(
      body: YourCustomTextFormField(
        focusNode: _customFieldFocus, // 将焦点节点传入自定义组件
      ),
    ),
  );
}

注意：自定义TextFormField内部的TextField需要正确接收外部传入的focusNode，否则焦点判断会失效。

针对Flutter 3.2.0+的替代方案 #

如果你的项目用了较新版本的Flutter，WillPopScope已被标记为废弃，推荐使用PopScope实现相同逻辑：

@override
Widget build(BuildContext context) {
  return PopScope(
    canPop: false, // 先阻止默认返回行为
    onPopInvoked: (bool didPop) async {
      final hasFocus = FocusManager.instance.primaryFocus?.hasFocus ?? false;
      if (hasFocus) {
        FocusManager.instance.primaryFocus?.unfocus();
      } else {
        // 无焦点时手动触发页面返回
        if (context.mounted) {
          Navigator.of(context).pop();
        }
      }
    },
    child: Scaffold(
      body: YourCustomTextFormField(),
    ),
  );
}

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