Flutter Autofocus问题：二级页面TextFormField聚焦异常及键盘问题

核心实现方案 #

针对你遇到的Release模式获焦失效、页面切换键盘不隐藏、页面恢复焦点丢失的问题，以下是具体解决步骤：

1. 正确管理FocusNode生命周期与获焦时机 #

在第二个页面中，通过WidgetsBinding监听页面生命周期，确保在渲染完成后请求焦点，同时处理页面切换和后台恢复的情况：

class SecondPage extends StatefulWidget {
  const SecondPage({super.key});

  @override
  State<SecondPage> createState() => _SecondPageState();
}

class _SecondPageState extends State<SecondPage> with WidgetsBindingObserver {
  late FocusNode _inputFocusNode;
  bool _needFocus = true;

  @override
  void initState() {
    super.initState();
    _inputFocusNode = FocusNode();
    WidgetsBinding.instance.addObserver(this);
    
    // 延迟到帧渲染完成后请求焦点，解决Release模式下直接调用失效的问题
    WidgetsBinding.instance.addPostFrameCallback((_) {
      if (_needFocus) _inputFocusNode.requestFocus();
    });
  }

  @override
  void didChangeAppLifecycleState(AppLifecycleState state) {
    super.didChangeAppLifecycleState(state);
    // 页面从后台恢复时重新获取焦点
    if (state == AppLifecycleState.resumed && _needFocus) {
      _inputFocusNode.requestFocus();
    }
  }

  @override
  void deactivate() {
    final isCurrentPage = ModalRoute.of(context)?.isCurrent ?? false;
    if (!isCurrentPage) {
      // 页面被切换走时，取消焦点并隐藏键盘
      _needFocus = false;
      _inputFocusNode.unfocus();
      // 强制隐藏全局焦点（防止其他控件抢占导致键盘不消失）
      FocusManager.instance.primaryFocus?.unfocus();
    } else {
      _needFocus = true;
    }
    super.deactivate();
  }

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

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('第二页')),
      body: Padding(
        padding: const EdgeInsets.all(16),
        child: TextFormField(
          focusNode: _inputFocusNode,
          decoration: const InputDecoration(hintText: '自动获焦输入框'),
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: () => Navigator.push(context, MaterialPageRoute(builder: (_) => const ThirdPage())),
        child: const Icon(Icons.arrow_forward),
      ),
    );
  }
}

2. 全局路由监听强化键盘控制 #

如果需要确保所有页面切换时都隐藏键盘，可以在MaterialApp中添加全局路由观察者：

final GlobalKey<_SecondPageState> secondPageKey = GlobalKey();

MaterialApp(
  navigatorObservers: [
    NavigatorObserver(
      didPush: (route, prevRoute) {
        // 新页面入栈时，强制隐藏键盘
        FocusManager.instance.primaryFocus?.unfocus();
      },
      didPop: (route, prevRoute) {
        // 返回第二页时，重新请求焦点
        if (prevRoute?.settings.name == '/second') {
          secondPageKey.currentState?._inputFocusNode.requestFocus();
        }
      },
    ),
  ],
  routes: {
    '/': (context) => const FirstPage(),
    '/second': (context) => SecondPage(key: secondPageKey),
    '/third': (context) => const ThirdPage(),
  },
)

关键注意事项 #

• Release模式获焦失效：必须避免在initState直接调用requestFocus，因为此时Widget未完成渲染，Release模式下的优化会导致请求被忽略，addPostFrameCallback是可靠的延迟执行方式
• 取消焦点失效：除了调用当前FocusNode的unfocus，还要调用FocusManager.instance.primaryFocus?.unfocus()强制清除全局焦点，确保键盘关闭
• 页面恢复焦点：通过didChangeAppLifecycleState监听后台恢复事件，重新触发焦点请求

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