You need to enable JavaScript to run this app. Flutter/Dart基于REST API实现用户注册的邮箱验证功能
优惠活动
大模型
产品
解决方案
定价
更多

Flutter/Dart基于REST API实现用户注册的邮箱验证功能

基于现有Auth类的邮箱验证流程实现

你现在的代码是调完注册接口就直接给用户开通登录态,要加邮箱验证不用推翻现有逻辑,顺着你正在用的接口能力改就行,核心调整就是把原来“注册完直接放行”的流程拆成三步:

  • 注册请求成功拿到临时ID Token之后,不激活登录态
  • 马上调用接口往用户填的注册邮箱发验证确认信
  • 等查到用户确实完成了邮箱验证,再把账号状态设为可用,正式走原来的登录逻辑

具体代码改造步骤

1. 调整现有状态判断逻辑

原来的isAuth判断只校验Token有效期,现在要加一层邮箱校验的前置条件,没验过邮箱的用户哪怕Token有效也不算正式登录:

// 新增状态标记:当前用户邮箱是否已完成验证
bool _isEmailVerified = false;

// 重写isAuth的判断规则
bool get isAuth {
  // 原有Token有效性判断保留,额外增加邮箱已验证的前置条件
  if (token == null || !_isEmailVerified) return false;
  return true;
}

2. 新增发送验证邮件的方法

复用你现有的接口请求逻辑,直接调用当前对接的身份工具包内置的发验证信能力:

Future<void> _sendEmailVerification(String idToken) async {
  final url = 'https://www.googleapis.com/identitytoolkit/v3/relyingparty/getOobConfirmationCode?key={MyAPIKEY}';
  try {
    await http.post(
      url,
      body: json.encode({
        'requestType': 'VERIFY_EMAIL', // 固定参数:指定发送邮箱验证类型的邮件
        'idToken': idToken, // 注册成功后拿到的临时Token
      }),
    );
  } catch (error) {
    // 发信失败直接把错误抛出,前端可以提示用户稍后点重发按钮
    throw error;
  }
}

3. 改造signup注册方法的流程

把原来注册成功后直接激活状态的逻辑调整为:

  1. 调用注册接口拿到临时ID Token
  2. 立刻触发发验证邮件的逻辑
  3. 暂存临时Token在内存里,不触发状态更新给前端提示,不把用户标记为已登录
Future<void> signup(String email, String password) async {
  final url = 'https://www.googleapis.com/identitytoolkit/v3/relyingparty/signupNewUser?key={MyAPIKEY}';
  try {
    final response = await http.post(
      url,
      body: json.encode({
        'email': email,
        'password': password,
        'returnSecureToken': true,
      }),
    );
    final responseData = json.decode(response.body);
    if (responseData['error'] != null) {
      throw HttpException(responseData['error']['message']);
    }

    // 这里只暂存临时Token,不写入正式的认证状态,不调用notifyListeners
    final tempToken = responseData['idToken'];
    // 触发发送验证邮件
    await _sendEmailVerification(tempToken);
    // 给前端返回明确提示:请查收邮件完成验证后再登录
  } catch (error) {
    throw error;
  }
}

4. 新增邮箱状态校验方法

当用户从邮件链接跳回应用、或者手动尝试登录时,用用户传入的凭证校验邮箱是否已完成验证,只有校验通过才激活正式登录态:

Future<bool> checkEmailVerified(String idToken) async {
  final url = 'https://www.googleapis.com/identitytoolkit/v3/relyingparty/lookup?key={MyAPIKEY}';
  try {
    final response = await http.post(
      url,
      body: json.encode({
        'idToken': idToken,
      }),
    );
    final responseData = json.decode(response.body);
    if (responseData['error'] != null) {
      throw HttpException(responseData['error']['message']);
    }
    // 接口返回的用户信息中自带emailVerified布尔字段
    final verified = responseData['users'][0]['emailVerified'] as bool;
    _isEmailVerified = verified;
    return verified;
  } catch (error) {
    throw error;
  }
}

原来的通用_authenticate方法要同步调整:在拿到登录接口返回的Token后,先调用这个校验方法,确认用户邮箱已验证,再写入正式的Token、过期时间这些状态,没验证的话直接抛出“请先完成邮箱验证”的错误,不激活登录态。

落地注意事项

  • 不要在注册发完验证信后就把临时Token存在本地持久化存储里,否则用户重启应用时会出现“明明没验邮箱但已经登录”的逻辑漏洞,临时Token只存在内存里就行,用户验证完成后再持久化正式的有效凭证
  • 给重发验证邮件的功能加前端60秒倒计时限制,避免短时间内高频调用触发接口的调用频率限制
  • 兼容用户在第三方邮件客户端操作完验证、没有自动跳回应用的场景:这时候引导用户回到应用用注册的邮箱密码手动登录,登录流程里调用上面的状态校验方法做判断,通过了再放行

内容的提问来源于stack exchange,提问作者mcfred

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.20 06:15:08