Flutter Web端Firebase Auth登录状态无法持久化刷新后丢失问题

问题根因 #

核心问题出在Firebase服务的初始化逻辑和持久化配置时机两个方面：

1. Firebase初始化顺序错误
   当前代码先调用Auth、Firestore的模拟器配置方法，再执行Firebase核心初始化，完全不符合SDK要求：必须先完成Firebase.initializeApp()核心初始化，才能对Auth、Firestore、Functions等子服务做参数配置、模拟器绑定。顺序错误会直接导致Auth的持久化规则失效，登录态不会写入localStorage。
2. 持久化配置时机错误
   setPersistence方法需要在Auth初始化完成后全局配置一次即可，放在登录方法内执行时，可能出现配置还未生效就已经完成了登录逻辑的情况，导致持久化规则没有被应用到本次登录操作中。

修复步骤 #

1. 修正main函数初始化顺序 #

调整后代码如下，把Firebase核心初始化放到所有子服务配置之前：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  // 第一步：先完成Firebase核心初始化
  await Firebase.initializeApp();
  // 第二步：再配置各个子服务的参数、模拟器
  await FirebaseAuth.instance.useAuthEmulator("localhost", 9099);
  // 全局提前配置Auth持久化规则
  await FirebaseAuth.instance.setPersistence(Persistence.LOCAL);

  FirebaseFirestore.instance.settings = Settings(
    host: "localhost:8080",
    sslEnabled: false,
    persistenceEnabled: false,
  );

  FirebaseFunctions.instance.useFunctionsEmulator("localhost", 5001);

  await EasyLocalization.ensureInitialized();

  runApp(_buildAppWithDependencies());
}

2. 移除登录方法中的重复持久化配置 #

删掉signInWithOneTimePassword方法里的await FirebaseAuth.instance.setPersistence(Persistence.LOCAL);代码，已经在初始化阶段全局配置过，不需要重复执行。

可选优化：调整用户转换逻辑的令牌刷新规则 #

你当前getIdTokenResult(true)每次都强制刷新令牌，在页面刷新刚恢复登录态时容易触发不必要的异常，建议默认使用缓存令牌，仅在需要更新自定义声明时才强制刷新：

extension on User {
  FutureOr<AuthUser> toUser() async {
    // 去掉强制刷新参数，优先使用缓存令牌
    final tokenResult = await this.getIdTokenResult();
    final claims = tokenResult.claims?.map<String, String>((key, value) => MapEntry(key, value.toString()));

    return AuthUser(
      id: uid,
      email: Email.dirty(email ?? ''),
      name: displayName ?? '',
      photoURL: Uri.parse(photoURL ?? ''),
      claims: claims ?? const {},
    );
  }
}

额外排查点 #

如果修改后仍有问题，检查Chrome浏览器的站点权限，确认没有开启「阻止所有Cookie」设置，允许localhost存储本地数据即可。

内容的提问来源于stack exchange，提问作者anonymous-dev