从其他路由返回主屏幕时键盘自动弹出，autofocus:false无效求解决

核心原因 #

问题本质是全局焦点未被正确释放：即便切换了标签页，带有TextField的标签页的焦点仍会被保留，当从其他路由返回时，Flutter焦点管理器会自动恢复之前的焦点状态，导致键盘弹出——哪怕当前显示的是无TextField的标签页。设置autofocus: false仅能阻止初始加载时的自动聚焦，无法处理路由返回时的焦点恢复逻辑。

具体解决方案 #

1. 导航前主动清除焦点

在触发路由跳转的代码中，先清除当前焦点再执行导航，从根源避免焦点残留：

void navigateToMenuScreen() {
  // 清除当前页面所有焦点
  FocusManager.instance.primaryFocus?.unfocus();
  // 执行路由跳转
  Navigator.push(context, MaterialPageRoute(builder: (_) => TargetScreen()));
}

如果导航逻辑分散，可在主屏幕的State类中通过路由监听统一处理：

class _HomeScreenState extends State<HomeScreen> with RouteAware {
  final RouteObserver<PageRoute> _routeObserver = RouteObserver<PageRoute>();

  @override
  void initState() {
    super.initState();
    WidgetsBinding.instance.addObserver(_routeObserver);
    _routeObserver.subscribe(this, ModalRoute.of(context)!);
  }

  @override
  void dispose() {
    _routeObserver.unsubscribe(this);
    WidgetsBinding.instance.removeObserver(_routeObserver);
    super.dispose();
  }

  @override
  void didPush() {
    // 主屏幕被新路由覆盖时，清除全局焦点
    FocusManager.instance.primaryFocus?.unfocus();
    super.didPush();
  }
}

2. 用FocusScope隔离标签页焦点

给每个标签页包裹FocusScope，让不同标签页的焦点相互独立，避免跨标签页的焦点残留：

TabBarView(
  children: [
    FocusScope(child: PageWithoutTextField()),
    FocusScope(child: PageWithTextField1()),
    FocusScope(child: PageWithTextField2()),
    FocusScope(child: PageWithoutTextField()),
    FocusScope(child: PageWithoutTextField()),
  ],
)

切换标签页时，当前FocusScope外的焦点会被自动释放，从路由返回时仅会恢复当前标签页的焦点（若存在），不会触发其他标签页的TextField键盘。

3. 页面恢复可见时强制清除焦点

如果前两种方案无效，可在主屏幕恢复可见时强制清除所有焦点，确保键盘不会自动弹出：

class _HomeScreenState extends State<HomeScreen> with WidgetsBindingObserver {
  @override
  void initState() {
    super.initState();
    WidgetsBinding.instance.addObserver(this);
  }

  @override
  void dispose() {
    WidgetsBinding.instance.removeObserver(this);
    super.dispose();
  }

  @override
  void didChangeAppLifecycleState(AppLifecycleState state) {
    super.didChangeAppLifecycleState(state);
    // 页面从后台或其他路由返回可见时，清除全局焦点
    if (state == AppLifecycleState.resumed) {
      FocusManager.instance.primaryFocus?.unfocus();
    }
  }
}

额外排查点 #

• 检查是否有自定义FocusNode被手动调用requestFocus()，导致焦点被强制获取；
• 排查第三方UI库是否存在自动聚焦逻辑，部分表单组件可能默认保留焦点状态。

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