使用Riverpod与Firebase通过Stream无法获取单个用户文档

根源定位 #

从堆栈跟踪可以明确，错误发生在UserProfile.fromMap方法的第26行，说明将Firestore文档数据转换为UserProfile实体类时出现异常，大概率是字段缺失或类型不匹配导致的。

具体解决方案 #

1. 检查Firestore文档状态 #

确认Firebase控制台中user-profiles集合下，对应用户UID（yEPCAfaHINVXuvEFohL6Tz5hdeN2）的文档是否存在：

• 如果文档不存在，需先创建该用户的配置文档
• 如果文档存在，核对所有字段的名称、类型是否与UserProfile.fromMap中的定义一致

2. 修复UserProfile.fromMap的空值处理 #

避免强制解包!导致的崩溃，为缺失字段设置默认值，示例：

factory UserProfile.fromMap(Map<String, dynamic> data, String uid) {
  return UserProfile(
    uid: uid,
    name: data['name'] ?? '', // 用默认值替代null
    email: data['email'] ?? '',
    // 其他字段同理，根据实际业务设置合理默认值
  );
}

3. 优化Repository的异常处理 #

即使文档不存在，也要保证Stream能返回合法对象，避免中断：

Stream<UserProfile> watchUser(String uid) => _fireStore
    .doc(userProfilePath(uid)) // 使用已定义的路径常量，减少硬编码错误
    .withConverter<UserProfile>(
        fromFirestore: (snapshot, _) {
          final data = snapshot.data();
          if (data == null) {
            // 文档不存在时返回空对象
            return UserProfile.empty(uid);
          }
          return UserProfile.fromMap(data, uid);
        },
        toFirestore: (user, _) => user.toMap())
    .snapshots()
    .map((snapshot) => snapshot.data() ?? UserProfile.empty(uid));

同时在UserProfile类中添加空对象构造函数：

factory UserProfile.empty(String uid) {
  return UserProfile(
    uid: uid,
    name: '',
    email: '',
    // 其他字段设置默认值
  );
}

4. 页面调试信息优化 #

修改错误回调，显示具体错误内容，方便调试：

error: (error, stackTrace) => Text('加载失败: ${error.toString()}'),

额外调试建议 #

• 开启Firestore调试日志，查看请求和返回的详细数据：

  FirebaseFirestore.instance.settings = const Settings(
    persistenceEnabled: false,
    logLevel: LogLevel.debug,
  );
  

• 核对Firebase安全规则，确保当前用户有权限读取自己的配置文档：

  match /user-profiles/{uid} {
    allow read, write: if request.auth != null && request.auth.uid == uid;
  }
  

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