Flutter TextFormField手机号校验错误信息异常：附带闭包描述问题

问题根源 #

1. 变量作用域错误：原代码中mobileNumber变量仅在第一个if块内定义，后续校验分支无法访问该变量，导致$mobileNumber被解析为static方法本身，从而输出包含Closure的错误信息。
2. static方法调用问题：移除static修饰符后，方法变为实例方法，必须通过类的实例才能调用，直接引用会导致无法访问。

修复方案 #

方案1：保留static方法（推荐用于工具类） #

修复变量作用域，并完善校验逻辑：

static String? mobileNumber(String? txt) {
  // 将提示文案变量提到方法最外层，确保所有分支可访问
  final mobileLabel = 'Mobile Number';
  
  if (txt == null || txt.isEmpty) {
    return "Invalid $mobileLabel!";
  }
  
  if (txt.length != 10) {
    return "$mobileLabel must have 10 characters";
  }
  
  if (!txt.contains(RegExp(r'^[0-9]+$'))) { // 修正正则：确保输入全为数字
    return "$mobileLabel must contain only digits";
  }
  
  // 校验通过必须返回null
  return null;
}

在TextFormField中使用：

TextFormField(
  validator: YourClassName.mobileNumber, // 直接传递static方法即可
  keyboardType: TextInputType.phone,
  // 其他属性...
)

方案2：改为实例方法（适用于State类内部） #

如果要移除static修饰符，将方法定义在Widget的State类中：

String? mobileNumber(String? txt) {
  final mobileLabel = 'Mobile Number';
  
  if (txt == null || txt.isEmpty) {
    return "Invalid $mobileLabel!";
  }
  
  if (txt.length != 10) {
    return "$mobileLabel must have 10 characters";
  }
  
  if (!txt.contains(RegExp(r'^[0-9]+$'))) {
    return "$mobileLabel must contain only digits";
  }
  
  return null;
}

在TextFormField中使用：

TextFormField(
  validator: mobileNumber, // 直接引用当前实例的方法
  keyboardType: TextInputType.phone,
  // 其他属性...
)

额外优化点 #

• 修正原文案中的语法错误：将must has改为must have/must contain only，更符合英文表达习惯。
• 优化正则表达式：使用^[0-9]+$确保输入全为数字，避免部分数字的情况。

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