StreamBuilder快照始终为空及空安全错误排查求助

核心问题分析 #

1. 泛型类型不匹配：StreamBuilder声明的List<ContactList>与stream实际返回的List<ChatContact>类型不一致，导致snapshot.data始终为null。
2. 不安全的空值断言：多处使用!强制解包可能为null的值（如snapshot.data!、userData.data()!），一旦数据不存在就触发空值错误。
3. 硬编码数据未绑定：ListTile的内容都是固定字符串，没有动态绑定stream返回的聊天数据。

步骤1：修复StreamBuilder泛型与空值检查 #

修改StreamBuilder的泛型为List<ChatContact>，并添加完整的状态判断，避免直接使用!：

StreamBuilder<List<ChatContact>>(
  stream: ref.watch(chatControllerProvider).getchatContacts(),
  builder: (context, snapshot) {
    if (snapshot.connectionState == ConnectionState.waiting) {
      return const CircularProgressIndicator();
    }
    // 处理错误情况
    if (snapshot.hasError) {
      return Center(child: Text('加载失败: ${snapshot.error}'));
    }
    // 处理无数据情况
    if (!snapshot.hasData || snapshot.data!.isEmpty) {
      return const Center(child: Text('暂无聊天记录'));
    }
    return ListView.builder(
      shrinkWrap: true,
      itemCount: snapshot.data!.length,
      itemBuilder: (context, index) {
        var chatContactData = snapshot.data![index];
        return Column(
          children: [
            InkWell(
              onTap: () {
                Navigator.pushNamed(
                  context,
                  UserChatScreen.routeName,
                  arguments: {
                    'name': chatContactData.name,
                    'selectedContactUID': chatContactData.contactID
                  },
                );
              },
              child: ListTile(
                title: Text(
                  chatContactData.name,
                  style: const TextStyle(fontSize: 18),
                ),
                subtitle: Padding(
                  padding: const EdgeInsets.only(top: 6.0),
                  child: Text(
                    chatContactData.lastMessage,
                    style: const TextStyle(fontSize: 15),
                  ),
                ),
                leading: CircleAvatar(
                  backgroundImage: NetworkImage(chatContactData.profilePic),
                  radius: 30,
                ),
                trailing: Text(
                  // 格式化时间（需导入intl包：import 'package:intl/intl.dart';）
                  DateFormat.jm().format(chatContactData.timeSent.toDate()),
                  style: const TextStyle(color: Colors.grey, fontSize: 13),
                ),
              ),
            ),
          ],
        );
      },
    );
  },
)

步骤2：修复Firestore数据获取的空值安全 #

在获取用户数据时，先判断文档是否存在，避免强制解包null：

return firestore
    .collection('users')
    .doc(auth.currentUser!.uid)
    .collection('chats')
    .snapshots()
    .asyncMap((event) async {
  List<ChatContact> contacts = [];
  for (var document in event.docs) {
    var chatContact = ChatContact.fromMap(document.data());
    
    // 获取用户数据前先检查文档是否存在
    var userData = await firestore
        .collection('users')
        .doc(chatContact.contactID)
        .get();
    
    if (!userData.exists) {
      // 若用户文档不存在，跳过当前联系人
      continue;
    }
    
    var user = model.User.fromMap(userData.data()!);
    contacts.add(
      ChatContact(
        name: user.name,
        profilePic: user.photoURL,
        contactID: chatContact.contactID,
        timeSent: chatContact.timeSent,
        lastMessage: chatContact.lastMessage,
      ),
    );
  }
  return contacts;
});

额外注意事项 #

• 确保ChatContact和model.User的fromMap方法能正确解析Firestore返回的字段，没有字段不匹配的情况。
• 如果用户头像可能为null，需要给NetworkImage添加占位图，比如用CircleAvatar(child: Text(user.name[0]))作为 fallback。
• 导入intl包来格式化时间：在pubspec.yaml中添加intl: ^0.18.1，然后运行flutter pub get。

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