Flutter Bloc开发:Firebase注册时序异常导致自定义用户读取失败问题
时序冲突的本质
Firebase Auth 的 currentUser 流会在createUserWithEmailAndPassword成功返回的瞬间立刻推送状态变化事件,这个触发时机远早于业务代码里写入Firestore自定义用户文档的动作,根本没有办法阻止Auth流的提前触发,只能通过逻辑兜底、流程调整的方式消除这个时序差。
可行的调整方案
方案1:AuthBloc 增加短间隔重试兜底(改动最小)
不需要调整现有注册流程的代码,只需要修改自定义用户查询的逻辑,当首次查询不到自定义用户时,带短延迟重试几次,等Firestore文档写入完成后再继续执行校验。
对应修改_mapAuthenticationUserChangedToState的核心逻辑:
Stream<AuthState> _mapAuthenticationUserChangedToState( AuthenticationUserChanged event) async* { if (event.user != null) { ApplicationUser? customUser; // 最多重试3次,每次间隔300ms,等待文档写入完成 for (int retry = 0; retry < 3; retry++) { customUser = await _authService.getUser(event.user.uid); // 查到有效文档直接跳出重试循环 if (customUser != null) break; await Future.delayed(const Duration(milliseconds: 300)); } // 后续原有有效期校验逻辑保持不变 if (customUser == null || customUser.expiration == "") { yield NotAuthorized(customUser ?? ApplicationUser(uid: event.user.uid)); return; } final isExpired = DateTime.now().toUtc().isAfter( DateTime.fromMillisecondsSinceEpoch( customUser.expiration.millisecondsSinceEpoch, isUtc: true, // 修正原代码的时区判断问题 )); yield isExpired ? NotAuthorized(customUser) : Authenticated(event.user); } else { // 修正原代码的拼写错误:Unautheticated → Unauthenticated yield Unauthenticated(); } }
- 优点:改动量最小,不需要调整注册流程的现有逻辑
- 缺点:依赖固定延迟重试,遇到Firestore写入延迟高于预设阈值的场景仍可能失效,会产生少量冗余请求
方案2:拆分注册流程的Auth状态触发时机(时序最可控)
把原来「创建用户→立刻被Auth流触发」的链路打断,等自定义文档写完后再重新触发Auth状态校验,修改signUpFormSubmitted的实现:
Future<void> signUpFormSubmitted() async { if (!state.status.isValidated) return; emit(state.copyWith(status: FormzStatus.submissionInProgress)); try { // 1. 先创建Firebase Auth用户 final userCred = await _authService.registerUser( state.email.value, state.password.value); // 2. 立刻登出,阻断AuthBloc对刚创建用户的初始事件响应 await _authService.signOut(); // 3. 写入自定义Firestore用户文档 final newUser = ApplicationUser( uid: userCred.user!.uid, email: userCred.user!.email!); await _authService.addUserToDocument(newUser); // 4. 文档写入完成后主动重新登录,此时AuthBloc触发时文档已存在 await _authService.loginUser(state.email.value, state.password.value); emit(state.copyWith(status: FormzStatus.submissionSuccess)); } on Exception { print(Exception); emit(state.copyWith(status: FormzStatus.submissionFailure)); } }
- 优点:时序完全由业务代码控制,AuthBloc永远在自定义文档写入完成后才执行校验,不会出现读空的情况
- 缺点:多了一次登出、登录的网络请求,会出现短暂的Unauthenticated状态闪屏
方案3:手动投递状态事件跳过自动流回调(最贴合Bloc架构)
利用Bloc的单向数据流设计,在注册流程完成自定义文档写入后,手动给AuthBloc投递认证事件,同时在AuthBloc加临时标记,忽略自动流推过来的第一次初始事件,避免重复触发:
- 在AuthBloc中增加跳过标记,改造流监听逻辑
class AuthBloc extends Bloc<AuthEvent, AuthState> { // 标记是否需要跳过自动流推送的下一次事件 bool skipNextAutoEvent = false; AuthBloc({@required AuthService authService}) : assert(authService != null), _authService = authService, super(AuthInitial()) { _userSubscription = _authService.currentUser.listen((user) { // 如果标记为跳过,就重置标记,不向Bloc投递事件 if (skipNextAutoEvent) { skipNextAutoEvent = false; return; } add(AuthenticationUserChanged(user)); }); } }
- 改造注册流程,在写完自定义文档后手动投递事件
// 完成Firestore自定义文档写入后 await _authService.addUserToDocument(newUser); // 标记AuthBloc跳过自动流即将推送的初始事件 _authBloc.skipNextAutoEvent = true; // 手动投递用户状态变化事件,此时文档已经存在,校验逻辑可以正常执行 _authBloc.add(AuthenticationUserChanged(userCred.user));
- 优点:没有额外的网络请求,没有状态闪屏,完全符合Bloc的数据流设计,时序100%可控
- 缺点:AuthBloc和RegisterCubit之间存在显式依赖,需要做好解耦避免循环依赖
常见避坑点
- 不要依赖Auth SDK的回调时机判断自定义文档是否存在,这个回调是SDK内部实现的,没有办法和Firestore的写入动作做同步
- 存
expiration字段的时候统一用UTC时间戳,不要用本地时区时间转UTC,避免时区差导致的有效期判断错误 - 不要把自定义用户的创建逻辑放到触发式Cloud Function里,Cloud Function冷启动的数秒延迟会放大时序差
内容的提问来源于stack exchange,提问作者Martin_Crsk
相关产品推荐
相关产品推荐

