Flutter中GlobalKey加static报重复键错误，不加则键盘自动隐藏求助

问题原因拆解 #

1. 添加static导致重复key错误
   static修饰的_formkey属于类而非实例，所有CustomForm实例会共享同一个全局key。当页面被多次创建（比如返回后重新进入），多个Form组件使用同一个key，就会触发Duplicate global key detected错误。

2. 不加static键盘自动隐藏
   你的login是无状态组件（StatelessWidget），当键盘弹出导致屏幕尺寸变化时，login会重新执行build方法，创建新的CustomForm实例，旧的State被销毁、新State生成，导致TextField失去焦点，键盘自动收起。

具体修复步骤 #

1. 移除GlobalKey的static修饰符

将State类中的全局key改为实例成员，确保每个CustomForm拥有独立的key：

class _CustomFormState extends State<CustomForm> {
  // 移除static，改为实例变量
  final _formkey = GlobalKey<FormState>();
  // ... 其他代码不变
}

2. 避免CustomForm意外重建

可选两种方式解决键盘弹出时的State重建问题：

方式一：给CustomForm添加稳定的Key

在login组件的build方法中，给CustomForm指定唯一的固定key，让Flutter识别为同一个组件，不会重建State：

class Login extends StatelessWidget { // 类名首字母大写，符合Dart规范
  const Login({super.key});

  @override
  Widget build(BuildContext context) {
    return Container(
      // ... 其他代码不变
      child: Scaffold(
          backgroundColor: Colors.transparent,
          body: Center(
              child: Container(
            height: MediaQuery.of(context).size.height * 0.7,
            width: MediaQuery.of(context).size.width * 0.8,
            // 添加固定key
            child: CustomForm(key: const ValueKey('login_custom_form')),
          ))),
    );
  }
}

方式二：将login改为StatefulWidget

把无状态的login改为有状态组件，确保组件状态被持久化，避免不必要的重建：

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

  @override
  State<Login> createState() => _LoginState();
}

class _LoginState extends State<Login> {
  @override
  Widget build(BuildContext context) {
    // 原login组件的build内容完全保留
    return Container(
      decoration: BoxDecoration(
        gradient: LinearGradient(
            begin: Alignment.topCenter,
            end: Alignment.bottomCenter,
            colors: [
              Colors.purpleAccent,
              Colors.lightBlue,
              Colors.indigoAccent
            ]),
      ),
      child: Scaffold(
          backgroundColor: Colors.transparent,
          body: Center(
              child: Container(
            height: MediaQuery.of(context).size.height * 0.7,
            width: MediaQuery.of(context).size.width * 0.8,
            child: CustomForm(),
          ))),
    );
  }
}

3. 添加控制器销毁逻辑（可选但推荐）

在_CustomFormState中重写dispose方法，销毁TextEditingController，避免内存泄漏：

@override
void dispose() {
  emailcontroller.dispose();
  passcontroller.dispose();
  super.dispose();
}

额外规范提示 #

Dart代码规范要求类名首字母大写，建议将login改为Login、forgetpass改为ForgetPass，避免潜在的命名冲突问题。

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