使用Cubit的copyWith发射状态后BlocBuilder不更新问题排查

问题1：Cubit中_filters与状态内filters不同步 #

你在Cubit里单独维护了_filters变量，但未确保它和当前state.filters始终一致。如果其他操作修改了状态的filters但未更新_filters，会导致toggleFilter操作的是过时数据，最终emit的新状态可能和旧状态的filters一致，Equatable判定状态未变化，BlocBuilder不触发更新。

解决方法：移除Cubit中的_filters变量，直接基于当前状态的filters修改：

void toggleFilter(FilterModel filter) {
  // 复制当前状态的filters，避免修改原列表
  final updatedFilters = List<CCouponCardType>.from(state.filters);
  if (updatedFilters.contains(filter)) {
    updatedFilters.remove(filter);
  } else {
    updatedFilters.add(filter);
  }
  
  emit(state.copyWith(filters: updatedFilters));
}

问题2：子类状态未重写copyWith方法 #

EmptyState、LoadingState、ErrorState都没有重写copyWith，调用它们的copyWith会返回父类CouponsState._的实例，导致状态类型变更，破坏状态一致性，还可能让Equatable的相等判断异常。

解决方法：给每个子类状态重写copyWith，确保返回同类型实例：
比如EmptyState：

class EmptyState extends CouponsState {
  const EmptyState({super.filters}) : super._();

  @override
  List<Object?> get props => [filters];

  @override
  EmptyState copyWith({List<CCouponCardType>? filters}) => EmptyState(
        filters: filters ?? this.filters,
      );
}

LoadingState和ErrorState参照此写法，实现各自的copyWith方法。

问题3：LoadedState的copyWith参数错误 #

LoadedState的copyWith中，couponsList: couponsList ?? this.couponsList里的couponsList是未定义变量（方法参数未声明），会导致编译错误。

解决方法：直接传入当前实例的couponsList：

@override
LoadedState copyWith({List<CCouponCardType>? filters}) => LoadedState(
      couponsList: this.couponsList,
      filters: filters ?? this.filters,
    );

问题4：ErrorState的props包含未定义字段 #

ErrorState的props里写了filterString和sort，但类中无这两个字段，会引发运行时错误。

解决方法：修正props为类中实际存在的字段：

@override
List<Object?> get props => [errorMessage, filters];

修正以上问题后，BlocBuilder就能正确响应状态变化了。

内容的提问来源于stack exchange，提问作者Rafael Stefani Baptista