Flutter文本框onSubmitted时切换焦点失效，如何解决？

问题根源是验证不通过时执行setState触发组件重建，同步执行的焦点请求会被组件重建过程打断，导致焦点切换失效。以下是两种针对性解决方案：

方案一：仅验证通过时切换焦点（符合常规业务逻辑） #

将焦点请求放在验证通过的分支内，避免验证失败时的状态更新干扰焦点切换：

onSubmitted: (value) {
  final isValid = widget.validator?.call(value) ?? true;
  if (!isValid) {
    setState(() {
      showError = true;
    });
  } else {
    if (widget.nextFocus != null) {
      FocusScope.of(context).requestFocus(widget.nextFocus);
    }
  }
},

方案二：强制切换焦点（无论验证结果） #

如果业务要求无论验证是否通过都要切换焦点，可通过WidgetsBinding.instance.addPostFrameCallback延迟焦点请求，确保在组件重建完成后执行：

onSubmitted: (value) {
  if (!widget.validator?.call(value)) {
    setState(() {
      showError = true;
    });
    // 延迟到当前帧绘制完成后执行焦点请求
    WidgetsBinding.instance.addPostFrameCallback((_) {
      if (widget.nextFocus != null) {
        FocusScope.of(context).requestFocus(widget.nextFocus);
      }
    });
  } else {
    if (widget.nextFocus != null) {
      FocusScope.of(context).requestFocus(widget.nextFocus);
    }
  }
},

原理说明 #

setState会触发组件树的同步重建，此时同步调用的requestFocus会被组件状态重置覆盖。使用addPostFrameCallback可以将焦点请求推迟到当前帧绘制完成、组件状态更新完毕后执行，保证焦点切换操作生效。

内容的提问来源于stack exchange，提问作者steind.VY