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注册方法的流程
把原来注册成功后直接激活状态的逻辑调整为:
- 调用注册接口拿到临时ID Token
- 立刻触发发验证邮件的逻辑
- 暂存临时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
相关产品推荐
相关产品推荐

