为何TextFormField的onSaved方法要求参数为可空String类型？

问题描述 #

我用以下代码测试TextFormField的onSaved回调：

final GlobalKey<FormState> _globalKey = GlobalKey();
  
@override
Widget build(BuildContext context) {
  return Scaffold(
    body: Column(
      children: [
        Form(
          key: _globalKey,
          child: TextFormField(onSaved: (String? string) {}),
        ),
        ElevatedButton(
          onPressed: () => _globalKey.currentState!.save(),
          child: Text('Save'),
        ),
      ],
    ),
  );
}

测试发现，即使输入框为空或从未聚焦，点击Save按钮时onSaved传入的仍是非空String，但如果把onSaved的参数声明为非空的String就会编译报错：

onSaved: (String string) {}, // 编译报错

想知道为什么onSaved的参数必须声明为可空的String?？

原因解释 #

虽然你测试时遇到的情况是传入非空值，但Flutter框架设计onSaved的参数为可空类型，是因为存在以下场景会传入null：

• 自定义输入控件场景：如果是你自己实现的继承自FormField的自定义输入控件，在save方法里可以主动返回null，框架需要兼容这种自定义场景。
• 特殊输入类型的边缘情况：比如日期选择器、开关类关联的FormField，当没有选中任何值时，onSaved可能会传入null。
• API扩展性考量：Flutter团队设计API时会预留扩展性，保留可空类型可以应对后续可能出现的新场景，避免API出现破坏性变更。

简单说，框架无法保证所有场景下onSaved的参数都是非空的，所以强制要求开发者声明为可空类型，这是API设计严谨性的体现——哪怕你当前测试场景不会出现null，也要兼容所有可能的情况。

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