Flutter StreamBuilder类型选择、快照捕获及circles类型问题

你不需要全局搜索修改circles相关的类型定义，只需要对齐StreamBuilder泛型、数据流输出、CirclePainter入参三处的类型即可，不需要依赖冗余的空安全检查绕开问题。

1. 当前场景适用的数据类型 #

• 你的数据源_circle$本身输出List<Circle>格式数据，经过map算子截取最近100条后的返回值依然是List<Circle>，因此StreamBuilder<List<Circle>>的泛型声明是完全正确的。
• 之所以需要做空安全检查，大概率是CirclePainter的circles入参被声明为了可空类型List<Circle>?，直接将该入参改为非空的List<Circle>、用required标记必填，就能从根源上消除不必要的空判断。

2. snapshot的捕获内容 #

此处的snapshot是AsyncSnapshot<List<Circle>>类型实例，它会实时捕获绑定流的全量状态，具体包含三类信息：

• 连接状态：通过snapshot.connectionState可获取当前流处于未连接、等待数据、活跃传输、已完成四种状态中的哪一种
• 有效数据：流最新一次正常吐出的结果会存在snapshot.data中，你传入的initialData: []会在流还未吐出第一帧有效数据时，作为默认值赋值给data
• 异常信息：如果流运行过程中抛出错误，错误对象会存在snapshot.error中

首先调整CirclePainter的类型声明：

class CirclePainter extends CustomPainter {
  // 声明为非空类型，不要加?
  final List<Circle> circles;
  CirclePainter({required this.circles});

  // 省略原有绘制逻辑
}

之后修改StreamBuilder部分逻辑，两种写法都可以避免多余空判断：

写法1：依赖initialData的非空保证（代码更简洁） #

@override
Widget build(BuildContext context) => Stack(
  children: [
    StreamBuilder<List<Circle>>(
      initialData: const <Circle>[],
      stream: _circle$.map((event) => event.length > 100
          ? event.getRange(event.length - 100, event.length).toList()
          : event),
      builder: (context, snapshot) {
        if (snapshot.hasError) {
          return const SizedBox.shrink();
        }
        // 已设置非空初始值，data不可能为null
        final circles = snapshot.data!;
        return CustomPaint(
          size: size,
          painter: CirclePainter(circles: circles),
        );
      },
    ),
  ],
);

写法2：加空兜底（容错性更高） #

不需要强制非空，哪怕后续误删initialData也不会触发空异常：

// builder内直接取数据时加空兜底
final circles = snapshot.data ?? const <Circle>[];
return CustomPaint(
  size: size,
  painter: CirclePainter(circles: circles),
);

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