Riverpod状态不更新：Firebase Auth用户信息流异常排查

问题根源 #

• 你的StreamProvider仅在初始化时创建了一次Firestore文档流，未绑定Firebase Auth的用户状态变化。当用户切换时，Auth状态更新但StreamProvider未重新执行，导致持续监听旧用户的文档数据。
• 首次登录触发Bad State，是因为注册后Firestore文档可能尚未创建完成，Stream已开始监听，此时文档不存在导致抛出状态错误。

解决方案 #

1. 绑定Auth状态流，让StreamProvider随用户切换重建 #

将Firebase Auth的用户状态流作为依赖，确保Auth状态变化时，StreamProvider重新创建对应用户的Firestore文档流。

示例代码：

// 监听Firebase Auth状态变化
final authStateProvider = StreamProvider<User?>((ref) {
  return FirebaseAuth.instance.authStateChanges();
});

// 基于Auth状态动态获取用户信息流
final userInfoProvider = StreamProvider<UserInfo?>((ref) {
  // 用ref.watch监听Auth状态，状态变化时自动重建流
  final authUser = ref.watch(authStateProvider).value;
  
  if (authUser == null) {
    return Stream.value(null);
  }

  // 监听当前用户的Firestore文档
  return FirebaseFirestore.instance
      .collection('users')
      .doc(authUser.uid)
      .snapshots()
      .map((snapshot) {
        // 处理文档不存在的情况，避免Bad State
        if (!snapshot.exists) return null;
        return UserInfo.fromFirestore(snapshot);
      });
});

2. 确保注册时文档写入完成再完成登录 #

在注册函数中等待Firestore文档写入完成后再返回，避免首次登录时流监听的文档还不存在。

注册函数示例：

Future<void> registerUser(String email, String password, String name, int targetCalories) async {
  final authCredential = await FirebaseAuth.instance.createUserWithEmailAndPassword(
    email: email,
    password: password,
  );

  // 等待用户信息文档写入完成
  await FirebaseFirestore.instance
      .collection('users')
      .doc(authCredential.user!.uid)
      .set({
        'name': name,
        'targetCalories': targetCalories,
      });
}

3. 必须使用ref.watch而非ref.read #

在StreamProvider内部监听依赖时，一定要用ref.watch，这样依赖状态变化时才会触发Provider重建。如果用ref.read，则不会感知到状态变化，Provider也不会重新执行。

调试验证 #

• 在userInfoProvider内添加print语句，切换用户时查看是否重新执行
• 首次登录后，确认Firestore文档已存在，流能正确返回用户信息，不再抛出Bad State

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