Flutter可复用Widget参数报错：添加可选参数时出错

错误原因 #

报错提示The parameter 'parametersValidate' can't have a value of 'null' because of its type, but the implicit default value is 'null'，核心问题是：
parametersValidate被声明为非空的String类型，但作为位置可选参数（用[]包裹），调用时若不传该参数，它会默认取null，而非空类型不允许赋值为null，因此触发错误。

修复方案 #

提供两种可行的修复方式，可根据实际需求选择：

方案1：将参数改为可空类型

把parametersValidate的类型改为String?（允许为null），这样位置可选参数的默认null就符合类型要求：

1. 修改类成员变量声明：

String? parametersValidate;

2. 构造函数中保持原写法即可：

[this.parametersValidate],

方案2：给参数设置默认值

如果业务上不允许parametersValidate为null，可以给它设置一个默认值（比如空字符串），确保即使不传参数也不会出现null：

1. 类成员变量保持原非空类型：

String parametersValidate;

2. 构造函数中给参数指定默认值：

[this.parametersValidate = ''],

额外优化建议 #

除了修复报错，还可以优化代码的类型安全性：

• 给Function类型指定具体签名，避免类型模糊：
  • 将Function functionValidate;改为String? Function(String?, String?)? functionValidate;
  • 将Function onSubmitField;改为VoidCallback? onSubmitField;
  • 将Function onFieldTap;改为VoidCallback? onFieldTap;
• 把不需要强制必填的参数（比如defaultText）也改为可空类型或设置默认值，符合你“仅4-5个必填参数”的需求。

修复后的完整代码示例 #

class TextFormFieldWidget extends StatefulWidget {
  // 必填参数（示例设为4个）
  final String hintText;
  final TextInputType textInputType;
  final TextEditingController controller;
  final TextInputAction actionKeyboard;

  // 可选参数
  final Widget prefixIcon;
  final String? defaultText;
  final FocusNode focusNode;
  final bool obscureText;
  final String? Function(String?, String?)? functionValidate;
  final String? parametersValidate;
  final VoidCallback? onSubmitField;
  final VoidCallback? onFieldTap;

  TextFormFieldWidget(
    this.hintText,
    this.textInputType,
    this.controller,
    this.actionKeyboard,
    // 位置可选参数
    [this.parametersValidate],
    // 命名可选参数（非必填，去掉required）
    {
      Key? key,
      this.prefixIcon = const SizedBox(),
      this.defaultText,
      this.focusNode = const FocusNode(),
      this.obscureText = false,
      this.functionValidate,
      this.onSubmitField,
      this.onFieldTap,
    }
  ) : super(key: key);

  @override
  _TextFormFieldWidgetState createState() => _TextFormFieldWidgetState();
}

class _TextFormFieldWidgetState extends State<TextFormFieldWidget> {
  double bottomPaddingToError = 12;

  @override
  Widget build(BuildContext context) {
    return Theme(
      data: Theme.of(context).copyWith(
        primaryColor: Colors.black,
      ),
      child: TextFormField(
        cursorColor: Colors.black,
        obscureText: widget.obscureText,
        keyboardType: widget.textInputType,
        textInputAction: widget.actionKeyboard,
        focusNode: widget.focusNode,
        style: const TextStyle(
          color: Colors.black,
          fontSize: 16.0,
          fontWeight: FontWeight.w200,
          fontStyle: FontStyle.normal,
          letterSpacing: 1.2,
        ),
        initialValue: widget.defaultText,
        decoration: InputDecoration(
          prefixIcon: widget.prefixIcon,
          hintText: widget.hintText,
          enabledBorder: const OutlineInputBorder(
            borderSide: BorderSide(color: Colors.black),
          ),
          focusedBorder: const OutlineInputBorder(
            borderSide: BorderSide(color: Colors.black),
          ),
          hintStyle: const TextStyle(
            color: Colors.grey,
            fontSize: 14.0,
            fontWeight: FontWeight.w300,
            fontStyle: FontStyle.normal,
            letterSpacing: 1.2,
          ),
          contentPadding: EdgeInsets.only(
              top: 12, bottom: bottomPaddingToError, left: 8.0, right: 8.0),
          isDense: true,
          errorStyle: const TextStyle(
            color: Colors.red,
            fontSize: 12.0,
            fontWeight: FontWeight.w300,
            fontStyle: FontStyle.normal,
            letterSpacing: 1.2,
          ),
          errorBorder: const OutlineInputBorder(
            borderSide: BorderSide(color: Colors.black),
          ),
          focusedErrorBorder: const OutlineInputBorder(
            borderSide: BorderSide(color: Colors.black),
          ),
        ),
        controller: widget.controller,
        validator: (value) {
          if (widget.functionValidate != null) {
            return widget.functionValidate!(value, widget.parametersValidate);
          }
          return null;
        },
        onFieldSubmitted: (value) {
          widget.onSubmitField?.call();
        },
        onTap: () {
          widget.onFieldTap?.call();
        },
      ),
    );
  }
}

String? commonValidation(String value, String messageError) {
  var required = requiredValidator(value, messageError);
  if (required != null) {
    return required;
  }
  return null;
}

String? requiredValidator(value, messageError) {
  if (value.isEmpty) {
    return messageError;
  }
  return null;
}

void changeFocus(
    BuildContext context, FocusNode currentFocus, FocusNode nextFocus) {
  currentFocus.unfocus();
  FocusScope.of(context).requestFocus(nextFocus);
}

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