Flutter TextFormField自动聚焦失效问题求助

核心问题：onFieldSubmitted的错误赋值 #

你代码里的onFieldSubmitted是直接执行了_fieldFocusChange函数，而非传递回调函数引用。这会导致Widget构建阶段就触发所有焦点切换逻辑，每个字段的onFieldSubmitted依次执行后，焦点最终被设置到最后一个目标——确认密码字段。

比如这段错误写法：

onFieldSubmitted: _fieldFocusChange(context, _nameFocus, _emailFocus),

这里不是传递回调，而是直接调用了_fieldFocusChange，把void类型的返回值传给了onFieldSubmitted，完全不符合回调的要求。

修复步骤 #

1. 修正onFieldSubmitted的回调传递方式

有两种简单的修复方式：

方式一：用匿名函数包裹调用
不需要修改原_fieldFocusChange，直接在字段中用匿名函数包裹：

onFieldSubmitted: (_) => _fieldFocusChange(context, _nameFocus, _emailFocus),

方式二：修改_fieldFocusChange为返回函数的形式

Function(String) _fieldFocusChange(FocusNode currentFocus, FocusNode nextFocus) {
  return (String value) {
    currentFocus.unfocus();
    FocusScope.of(context).requestFocus(nextFocus);
  };
}

然后在字段中使用：

onFieldSubmitted: _fieldFocusChange(_nameFocus, _emailFocus),

2. 确保初始焦点请求在Widget构建完成后执行

initState中直接调用_nameFocus.requestFocus()可能因Widget未完成挂载失效，改用WidgetsBinding延迟执行：

@override
void initState() {
  super.initState();
  _nameFocus = FocusNode(debugLabel: 'Name Focus');
  _emailFocus = FocusNode(debugLabel: 'Email Focus');
  _passwordFocus = FocusNode(debugLabel: 'PW Focus');
  _passwordConfirmFocus = FocusNode(debugLabel: 'CPW Focus');
  
  // 延迟到Widget构建完成后请求焦点
  WidgetsBinding.instance.addPostFrameCallback((_) {
    _nameFocus.requestFocus();
  });
}

3. 验证自定义RoundedTextFormField的参数传递

确保你的自定义组件正确把autofocus和focusNode传给内部的TextFormField，比如：

class RoundedTextFormField extends StatelessWidget {
  final bool autoFocus;
  final FocusNode? focusNode;
  // 其他参数...

  const RoundedTextFormField({
    super.key,
    this.autoFocus = false,
    this.focusNode,
    // 其他参数初始化...
  });

  @override
  Widget build(BuildContext context) {
    return TextFormField(
      autofocus: autoFocus,
      focusNode: focusNode,
      // 其他属性传递...
    );
  }
}

修复后测试效果 #

完成修改后重新运行：

• 页面加载时，姓名字段会自动获取焦点
• 点击键盘“下一页”按钮，会依次切换到邮箱、密码、确认密码字段
• 确认密码字段点击“完成”后，正常触发提交逻辑

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