连续yield多个状态但BlocBuilder未全部接收的问题排查

首先明确几个核心问题的答案：

• 是否允许连续发送多个状态？ 完全允许！BLoC的设计初衷就是支持通过Stream发送一系列状态，比如加载中→成功/失败这类流程，连续yield多个状态是标准用法。
• 状态变更的yield频率有何限制？ 没有硬性的技术限制，但要考虑性能：短时间内发送大量状态会导致Widget频繁重建，可能引发UI卡顿，所以建议只在必要时发送状态。

回到你的问题：日志显示状态已正确yield，但BlocBuilder只收到最终的IsGreen/IsRed，大概率是以下两个原因之一：

1. 同步执行导致中间状态被快速覆盖 #

你的doSomeStuff()方法里，doSomething()是同步方法，这意味着yield IsBlue(result)之后会立刻执行yield IsGreen()——两个状态几乎同时被推入Stream。而Flutter的Widget重建是绑定到帧周期的，可能IsBlue的状态还没来得及触发BlocBuilder的重建，IsGreen就已经到达，导致视觉上看不到中间状态（但日志能记录到yield操作）。

解决方法： #

给中间状态添加短暂延迟，让UI有足够时间渲染：

Stream<MyState> doSomeStuff() async* {
  try {
    String result = doSomething();
    yield IsBlue(result);
    // 让蓝色状态显示一段时间，比如500毫秒
    await Future.delayed(const Duration(milliseconds: 500));
  } on MyException {
    yield IsException();
    // 异常提示可以显示久一点
    await Future.delayed(const Duration(milliseconds: 1500));
  }
  yield IsGreen();
}

2. BlocBuilder的buildWhen过滤了中间状态 #

如果你在使用BlocBuilder时设置了buildWhen参数，并且只允许IsRed/IsGreen触发重建，那中间的IsBlue/IsException会被直接忽略。

检查点： #

确保你的BlocBuilder没有类似这样的过滤逻辑：

// 错误示例：过滤掉了IsBlue和IsException
BlocBuilder<MyBloc, MyState>(
  buildWhen: (previous, current) => current is IsRed || current is IsGreen,
  builder: (context, state) {
    // ...
  },
)

正确的做法是要么移除buildWhen，要么把中间状态也加入判断：

BlocBuilder<MyBloc, MyState>(
  buildWhen: (previous, current) {
    return current is IsRed || current is IsGreen || current is IsBlue || current is IsException;
  },
  builder: (context, state) {
    if (state is IsRed) return RedWidget();
    if (state is IsGreen) return GreenWidget();
    if (state is IsBlue) return BlueWidget(result: state.result);
    if (state is IsException) return ExceptionNotification();
    return const SizedBox();
  },
)

额外排查点：状态类的==和hashCode实现 #

如果你的MyState子类没有正确实现==和hashCode，BLoC可能会误判新状态和当前状态相等，从而跳过状态更新。比如如果IsBlue和IsGreen的==逻辑写得有问题，就会导致中间状态被忽略。

确保每个状态类的相等判断正确，比如：

abstract class MyState {}

class IsRed extends MyState {
  @override
  bool operator ==(Object other) => identical(this, other) || other is IsRed;

  @override
  int get hashCode => runtimeType.hashCode;
}

class IsGreen extends MyState {
  @override
  bool operator ==(Object other) => identical(this, other) || other is IsGreen;

  @override
  int get hashCode => runtimeType.hashCode;
}

class IsBlue extends MyState {
  final String result;

  IsBlue(this.result);

  @override
  bool operator ==(Object other) =>
      identical(this, other) ||
      other is IsBlue &&
          runtimeType == other.runtimeType &&
          result == other.result;

  @override
  int get hashCode => runtimeType.hashCode ^ result.hashCode;
}

class IsException extends MyState {
  @override
  bool operator ==(Object other) => identical(this, other) || other is IsException;

  @override
  int get hashCode => runtimeType.hashCode;
}

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