如何无需重新登录即可刷新Firebase Authentication用户信息

场景说明 #

你的Flutter应用使用Firebase Authentication的邮箱/密码认证，通过StreamProvider获取用户信息：

StreamProvider<UserModel?>.value(
  initialData: null,
  catchError: (_, op) => null,
  value: AuthService().user,
),

通过以下方法获取当前用户：

User? getCurrentUser() {
  return _auth.currentUser;
}

登录、登出、注册、找回密码功能正常，但邮箱验证后emailVerified状态无法自动更新，仅重新登录后才会刷新。

问题解答 #

1. 这种需要手动调用reload的情况是否正常？

这是完全正常的。Firebase Auth客户端会缓存用户对象到本地，默认不会主动同步服务器端的用户状态变更——包括邮箱验证状态。只有重新登录（会重新从服务器拉取完整用户信息）或者主动调用reload()方法，才会更新本地缓存的用户数据。

2. 何时需要调用reload？

• 用户完成邮箱验证操作后，建议立即调用reload()同步状态，避免用户在未刷新状态下遇到功能限制
• 当你明确知道服务器端用户属性发生变更时（比如用户在其他设备修改了个人资料、后台修改了用户权限）
• 在依赖用户最新状态的业务逻辑执行前（比如判断是否允许用户进入需要验证邮箱的页面）

3. 仅针对未验证邮箱的账户吗？

不是。所有服务器端的用户属性变更，客户端本地缓存都不会自动同步，都需要调用reload()。比如：

• 用户修改了绑定的邮箱地址
• 用户更新了密码
• 用户修改了displayName、photoURL等个人资料
• 后台修改了用户的自定义Claims（如权限角色）
• 用户账户被后台禁用/启用

4. 还有哪些用户信息更新可能遗漏？

除了邮箱验证状态，以下服务器端变更也不会自动同步到客户端缓存：

• 用户绑定的手机号码变更
• 用户的多因素认证（MFA）状态变更
• 用户的邮箱地址被后台修改
• 用户的账户权限（自定义Claims）更新
• 用户的账户状态（是否被禁用）变更

内容的提问来源于stack exchange，提问作者under