Flutter中如何将应用从后台切回前台时自动恢复之前聚焦的TextField

核心思路是记录输入框在应用退后台前的聚焦状态，仅当之前确实处于聚焦状态时，才在应用回到前台时恢复焦点。

实现步骤： #

1. 定义变量保存聚焦状态，同时初始化FocusNode：

final FocusNode _inputFocusNode = FocusNode();
bool _wasInputFocused = false;

2. 在initState中监听FocusNode的焦点变化，实时更新状态：

@override
void initState() {
  super.initState();
  // 监听输入框焦点变化
  _inputFocusNode.addListener(() {
    if (_inputFocusNode.hasFocus) {
      _wasInputFocused = true;
    } else {
      // 仅用户主动操作导致的失焦才标记为false，避免应用退后台的被动失焦干扰
      if (WidgetsBinding.instance.lifecycleState != AppLifecycleState.paused) {
        _wasInputFocused = false;
      }
    }
  });
  // 绑定应用生命周期监听
  WidgetsBinding.instance.addObserver(this);
}

3. 重写didChangeAppLifecycleState方法，在应用回到前台时恢复焦点：

@override
void didChangeAppLifecycleState(AppLifecycleState state) {
  super.didChangeAppLifecycleState(state);
  if (state == AppLifecycleState.resumed) {
    if (_wasInputFocused) {
      // 延迟执行确保界面状态稳定，避免焦点请求失效
      WidgetsBinding.instance.addPostFrameCallback((_) {
        _inputFocusNode.requestFocus();
      });
    }
  } else if (state == AppLifecycleState.paused) {
    // 应用退后台时，记录当前输入框的聚焦状态
    _wasInputFocused = _inputFocusNode.hasFocus;
  }
}

4. 在dispose中清理资源：

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

关键细节： #

• 区分主动失焦和被动失焦：只有用户主动点击其他区域导致的失焦才更新状态，应用退后台的被动失焦不修改状态，保证记录的准确性。
• 延迟请求焦点：通过addPostFrameCallback确保应用恢复后界面完全初始化，再执行焦点请求，避免无效操作。

如果使用Flutter 3.10+版本，可改用更简洁的AppLifecycleListener写法：

@override
void initState() {
  super.initState();
  _inputFocusNode.addListener(() {
    if (_inputFocusNode.hasFocus) {
      _wasInputFocused = true;
    } else if (WidgetsBinding.instance.lifecycleState != AppLifecycleState.paused) {
      _wasInputFocused = false;
    }
  });

  AppLifecycleListener(
    onResume: () {
      if (_wasInputFocused) {
        WidgetsBinding.instance.addPostFrameCallback((_) {
          _inputFocusNode.requestFocus();
        });
      }
    },
    onPause: () {
      _wasInputFocused = _inputFocusNode.hasFocus;
    },
  );
}

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