注册时如何在Firestore中检查手机号字符串是否重复？

首先要明确：TextFormField的validator是同步回调函数，无法直接在里面执行异步的Firestore查询操作，所以需要调整验证流程，以下是两种可行的实现方案：

方案一：表单提交时统一检查 #

先通过validator完成手机号格式验证，在用户点击注册按钮时，再异步查询Firestore判断手机号是否重复。

1. 保留原有格式验证逻辑 #

final phoneField = TextFormField(
  controller: phoneController,
  keyboardType: TextInputType.phone,
  autofocus: false,
  autocorrect: false,
  textInputAction: TextInputAction.next,
  validator: (value) {
    RegExp regex = RegExp(r'(^(?:[00]+)?[0-9]{10,15}$)');
    if (value!.isEmpty) {
      return AppLocalizations.of(context)!.phoneValidationEmpty;
    }
    if (!regex.hasMatch(value)) {
      return "请输入有效的手机号";
    }
    // 格式验证通过，返回null
    return null;
  },
  onSaved: (value) {
    phoneController.text = value!;
  },
  textAlign: TextAlign.center,
  decoration: InputDecoration(
    prefixIcon: Icon(Icons.phone),
    contentPadding: EdgeInsets.fromLTRB(20, 15, 20, 15),
    hintText: AppLocalizations.of(context)!.phoneNumber,
    border: OutlineInputBorder(
      borderRadius: BorderRadius.circular(10),
    ),
  ),
);

2. 在注册按钮的点击事件中添加重复检查 #

先定义表单Key：

final _formKey = GlobalKey<FormState>();

然后编写提交逻辑：

ElevatedButton(
  onPressed: () async {
    // 先执行格式验证
    if (_formKey.currentState!.validate()) {
      // 查询Users集合中是否存在相同手机号
      final querySnapshot = await FirebaseFirestore.instance
          .collection('Users')
          .where('phone', isEqualTo: phoneController.text.trim())
          .get();

      if (querySnapshot.docs.isNotEmpty) {
        // 手机号已存在，提示用户
        ScaffoldMessenger.of(context).showSnackBar(
          const SnackBar(content: Text('该手机号已被注册')),
        );
      } else {
        // 手机号可用，执行后续注册流程（比如保存用户数据、创建Firebase邮箱认证用户）
        _formKey.currentState!.save();
        // 这里添加你的注册逻辑
      }
    }
  },
  child: const Text('注册'),
)

方案二：实时异步检查（用户输入时自动验证） #

通过状态变量存储重复错误信息，结合onChanged触发异步查询，配合autovalidateMode实时更新验证状态。

1. 定义状态变量 #

在Widget的State类中添加：

String? _phoneDuplicateError;

2. 编写异步检查函数 #

Future<void> _checkPhoneDuplicate(String phone) async {
  final querySnapshot = await FirebaseFirestore.instance
      .collection('Users')
      .where('phone', isEqualTo: phone.trim())
      .get();

  setState(() {
    _phoneDuplicateError = querySnapshot.docs.isNotEmpty ? '该手机号已被注册' : null;
  });
}

3. 修改TextFormField配置 #

final phoneField = TextFormField(
  controller: phoneController,
  keyboardType: TextInputType.phone,
  autofocus: false,
  autocorrect: false,
  textInputAction: TextInputAction.next,
  validator: (value) {
    RegExp regex = RegExp(r'(^(?:[00]+)?[0-9]{10,15}$)');
    if (value!.isEmpty) {
      return AppLocalizations.of(context)!.phoneValidationEmpty;
    }
    if (!regex.hasMatch(value)) {
      return "请输入有效的手机号";
    }
    // 返回重复检查的错误信息
    return _phoneDuplicateError;
  },
  onChanged: (value) {
    // 仅当格式合法时才触发重复检查，避免无效请求
    final validFormat = RegExp(r'(^(?:[00]+)?[0-9]{10,15}$)').hasMatch(value);
    if (validFormat) {
      _checkPhoneDuplicate(value);
    } else {
      setState(() {
        _phoneDuplicateError = null;
      });
    }
  },
  // 用户输入时自动验证
  autovalidateMode: AutovalidateMode.onUserInteraction,
  onSaved: (value) {
    phoneController.text = value!;
  },
  textAlign: TextAlign.center,
  decoration: InputDecoration(
    prefixIcon: Icon(Icons.phone),
    contentPadding: EdgeInsets.fromLTRB(20, 15, 20, 15),
    hintText: AppLocalizations.of(context)!.phoneNumber,
    border: OutlineInputBorder(
      borderRadius: BorderRadius.circular(10),
    ),
  ),
);

注意事项 #

• 建议在Firestore的Users集合的phone字段上创建单字段索引，避免查询时出现索引缺失错误，提升查询性能。
• 实时检查方案会产生较多Firestore请求，可根据需求调整触发时机（比如用户输入完成后延迟1秒再查询），减少不必要的请求。

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