Flutter：解决StreamBuilder中Object无法赋值给Map<String,dynamic>的问题

你的代码主要有两个核心问题导致报错：

• 直接强制解包document.data()，若文档数据为空会触发空指针异常
• 直接使用data['name']、data['status']，若字段不存在或为null，Text组件会因接收null参数报错

以下是修复后的完整代码：

StreamBuilder<QuerySnapshot>(
  stream: users.snapshots(),
  builder: (BuildContext context, AsyncSnapshot<QuerySnapshot> snapshot) {
    if (snapshot.hasError) {
      return const Center(child: Text("Something went wrong"));
    }

    if (snapshot.connectionState == ConnectionState.waiting) {
      return const Center(child: Text("Loading"));
    }

    // 处理快照数据为空的边界情况
    final docs = snapshot.data?.docs ?? [];
    return CustomScrollView(
      slivers: [
        SliverList(
          // 改用SliverChildBuilderDelegate，仅构建可见项，性能更优
          delegate: SliverChildBuilderDelegate(
            (context, index) {
              final document = docs[index];
              // 安全转换数据，避免空指针
              final data = document.data() as Map<String, dynamic>? ?? {};
              // 给字段设置默认值，防止null导致组件崩溃
              final name = data['name'] ?? '未知用户';
              final status = data['status'] ?? '离线';
              final uid = data['uid'] ?? '';

              return ListTile(
                onTap: () => uid.isNotEmpty ? callChatDetailsScreen(context, name, uid) : null,
                title: Text(name),
                subtitle: Text(status),
              );
            },
            childCount: docs.length,
          ),
        )
      ],
    );
  },
)

关键修复说明： #

• 用snapshot.data?.docs ?? []处理快照数据为空的场景，避免后续操作报错
• 将document.data()安全转换为Map<String, dynamic>?，并设置默认空字典?? {}，防止数据为null时崩溃
• 给name、status、uid字段设置默认值，确保Text组件和跳转函数不会接收null参数
• 替换SliverChildListDelegate为SliverChildBuilderDelegate，数据量大时性能更优
• 给onTap添加uid.isNotEmpty判断，避免传递无效uid触发错误

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