Flutter表单提交最佳实践咨询：自定义FormHandler类是否合理？

你的FormHandler类确实朝着关注点分离的方向迈出了正确一步，把表单验证、提交逻辑从UI组件中抽离，避免了UI代码臃肿，符合模块化设计思路，这个核心方向是合理的。

1. formInput依赖外部传入，状态管理风险
   你将formInput作为构造参数传入，意味着这个Map的生命周期由外部控制，可能出现外部意外修改导致表单数据不一致的情况；同时如果多个表单复用同一个FormHandler，会出现数据污染。

2. 提交逻辑与业务强耦合
   submitCourse方法直接绑定了“课程提交”的业务逻辑，导致FormHandler无法复用在其他表单场景中，违背了通用工具类的设计初衷。

3. 验证方法扩展性不足
   静态的validateTextInput只能处理单一的非空验证，无法针对不同字段（比如邮箱、手机号、长度限制）做定制化验证，也不支持组合验证。

4. 缺乏异步验证支持
   实际开发中很多验证需要调用接口（比如检查用户名是否重复），当前实现只能处理同步验证，无法覆盖这类场景。

5. 错误状态与反馈缺失
   没有统一管理表单的错误状态，UI层无法直接从FormHandler获取全局错误信息，只能依赖Flutter Form组件自身的字段错误提示，灵活性不足。

6. FormKey传递不够优雅
   每次提交都需要手动传入formKey，增加了UI层和FormHandler的耦合度，也容易出现遗漏或错误传递的情况。

1. 内部维护表单数据，封装状态 #

将formInput改为FormHandler内部私有变量，通过方法暴露数据读写，避免外部直接修改：

class FormHandler {
  final Map<String, dynamic> _formInput = {};

  // 提供读取数据的方法
  dynamic getInput(String key) => _formInput[key];

  // 提供设置数据的方法（配合FormField的onSaved使用）
  void setInput(String key, dynamic value) => _formInput[key] = value;
}

2. 抽象提交逻辑，解耦业务 #

把提交逻辑改成回调函数，让FormHandler只做通用的验证、保存逻辑，具体业务由外部传入：

void submit({
  required GlobalKey<FormState> formKey,
  required void Function(Map<String, dynamic>) onValidated,
}) {
  final form = formKey.currentState;
  if (form?.validate() ?? false) {
    form?.save();
    onValidated(_formInput);
  }
}

使用时在UI层传入业务逻辑：

formHandler.submit(
  formKey: _formKey,
  onValidated: (data) {
    // 这里调用数据库控制器创建课程
    databaseController.createCourse(data);
  },
);

3. 优化验证机制，支持定制化 #

将验证方法改为可配置的验证器，支持为不同字段设置不同规则：

// 定义验证器类型
typedef Validator<T> = String? Function(T? value);

class FormHandler {
  // 存储字段对应的验证器
  final Map<String, Validator> _validators = {};

  // 添加字段验证器
  void addValidator(String key, Validator validator) {
    _validators[key] = validator;
  }

  // 通用验证方法，供FormField使用
  String? validateField(String key, dynamic value) {
    return _validators[key]?.call(value);
  }
}

使用时为字段添加验证规则：

formHandler.addValidator('email', (value) {
  if (value == null || value.isEmpty) return '邮箱不能为空';
  if (!RegExp(r'^[\w-\.]+@([\w-]+\.)+[\w-]{2,4}$').hasMatch(value)) {
    return '请输入正确的邮箱格式';
  }
  return null;
});

4. 支持异步验证 #

添加异步验证方法，配合Flutter的AutovalidateMode或手动触发：

Future<String?> validateFieldAsync(String key, dynamic value) async {
  final validator = _validators[key];
  if (validator is FutureOr<String?> Function(dynamic)) {
    return await validator(value);
  }
  return validator?.call(value);
}

5. 统一管理错误状态 #

在FormHandler中添加错误信息存储，方便UI层获取全局或字段错误：

class FormHandler {
  final Map<String, String?> _errors = {};

  String? getError(String key) => _errors[key];

  void setError(String key, String? error) {
    _errors[key] = error;
    // 可以添加状态通知，比如使用ChangeNotifier让UI监听变化
  }
}

6. 封装FormKey，降低耦合 #

将FormKey封装到FormHandler内部，减少UI层的代码：

class FormHandler {
  final GlobalKey<FormState> _formKey = GlobalKey<FormState>();

  GlobalKey<FormState> get formKey => _formKey;

  void submit({required void Function(Map<String, dynamic>) onValidated}) {
    final form = _formKey.currentState;
    if (form?.validate() ?? false) {
      form?.save();
      onValidated(_formInput);
    }
  }
}

import 'package:flutter/material.dart';

typedef Validator<T> = String? Function(T? value);
typedef AsyncValidator<T> = Future<String?> Function(T? value);

class FormHandler extends ChangeNotifier {
  final Map<String, dynamic> _formInput = {};
  final Map<String, dynamic> _validators = {};
  final Map<String, String?> _errors = {};
  final GlobalKey<FormState> _formKey = GlobalKey<FormState>();

  GlobalKey<FormState> get formKey => _formKey;
  Map<String, dynamic> get formData => Map.unmodifiable(_formInput);
  String? getError(String key) => _errors[key];

  void addValidator(String key, Validator validator) {
    _validators[key] = validator;
  }

  void addAsyncValidator(String key, AsyncValidator validator) {
    _validators[key] = validator;
  }

  void setInput(String key, dynamic value) {
    _formInput[key] = value;
    notifyListeners();
  }

  void setError(String key, String? error) {
    _errors[key] = error;
    notifyListeners();
  }

  String? validateField(String key, dynamic value) {
    final validator = _validators[key];
    if (validator is Validator) {
      final error = validator(value);
      _errors[key] = error;
      return error;
    }
    return null;
  }

  Future<String?> validateFieldAsync(String key, dynamic value) async {
    final validator = _validators[key];
    if (validator is AsyncValidator) {
      final error = await validator(value);
      _errors[key] = error;
      notifyListeners();
      return error;
    }
    return validateField(key, value);
  }

  Future<void> submit({required void Function(Map<String, dynamic>) onValidated}) async {
    final form = _formKey.currentState;
    if (form?.validate() ?? false) {
      form?.save();
      // 可选：执行所有异步验证
      final asyncValidations = _validators.entries
          .where((entry) => entry.value is AsyncValidator)
          .map((entry) => validateFieldAsync(entry.key, _formInput[entry.key]));
      await Future.wait(asyncValidations);

      if (_errors.values.every((e) => e == null)) {
        onValidated(formData);
      }
    }
  }
}

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