Flutter中使用Form组件时键盘自动关闭，求保留表单验证的解决办法

问题场景 #

在Form组件内嵌套ListView使用TextFormField时，触发表单验证（通过Form的key）会导致键盘自动关闭；移除Form后键盘可正常使用，但需要保留Form的表单验证功能。

核心原因 #

Form在验证过程中会触发子组件重建，默认配置的ListView会因焦点抢占或重绘导致输入框失去焦点，进而使键盘收起。

解决方案 #

1. 给ListView设置primary: false #

默认情况下ListView的primary属性为true，会自动关联父级ScrollController并抢占焦点。将其设为false可避免Form重建时ListView干扰输入框焦点：

Form(
  key: _formKeyPlant,
  child: ListView(
    primary: false, // 添加该配置
    children: [
      // 你的表单内容...
    ],
  ),
)

2. 检查CustomTextField的封装正确性 #

确保CustomTextField基于TextFormField封装（而非普通TextField），并正确传递validator等Form关联参数。示例正确封装：

class CustomTextField extends StatelessWidget {
  final TextEditingController controller;
  final String? title;
  final String? Function(String?)? validator;
  // 其他所需参数

  const CustomTextField({
    super.key,
    required this.controller,
    this.title,
    this.validator,
    // 其他参数初始化
  });

  @override
  Widget build(BuildContext context) {
    return Column(
      crossAxisAlignment: CrossAxisAlignment.start,
      children: [
        if (title != null) Text(title!),
        TextFormField( // 必须使用TextFormField
          controller: controller,
          validator: validator,
          // 其他输入框配置
        ),
      ],
    );
  }
}

3. 改用SingleChildScrollView替代ListView（可选） #

若表单无需ListView的复杂列表特性，改用SingleChildScrollView可减少层级和重建问题：

Form(
  key: _formKeyPlant,
  child: SingleChildScrollView(
    padding: const EdgeInsets.symmetric(horizontal: 18),
    child: Column(
      children: [
        // 你的表单内容...
      ],
    ),
  ),
)

4. 避免不必要的Form重建 #

触发验证时仅调用表单验证方法，不要触发页面整体重建。示例提交按钮逻辑：

ElevatedButton(
  onPressed: () {
    if (_formKeyPlant.currentState?.validate() ?? false) {
      // 验证通过后的业务逻辑
    }
  },
  child: const Text('提交'),
)

验证方式 #

修改后测试：唤起键盘后触发表单验证，确认键盘保持打开且验证功能正常运行。

内容的提问来源于stack exchange，提问作者Mr.Robot