You need to enable JavaScript to run this app. Flutter Bloc开发:Firebase注册时序异常导致自定义用户读取失败问题
优惠活动
大模型
产品
解决方案
定价
更多

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加临时标记,忽略自动流推过来的第一次初始事件,避免重复触发:

  1. 在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));
    });
  }
}
  1. 改造注册流程,在写完自定义文档后手动投递事件
// 完成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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.30 22:27:04