Flutter Bloc问题：按钮更新Firestore文档后UI未刷新

问题场景 #

点击按钮可正常更新Firestore文档，但UI未随之刷新；手动修改Firestore文档时，UI能正常响应更新。相关代码涉及Bloc监听Firestore文档流、PageHomeState状态类与UserEntity实体类。

核心原因 #

问题出在Equatable对List的引用比较逻辑：

• Equatable默认通过引用比较props中的List类型字段，而非内容比较。
• 点击按钮更新Firestore时，若Repository返回的UserEntity复用了旧实例的List引用（比如从本地缓存直接取），Equatable会判定userData未变化，Bloc不会触发状态更新，UI也就不会刷新。
• 手动修改Firestore时，Firebase返回的是全新的快照数据，List是新引用，Equatable能识别到变化，触发UI更新。

解决方案 #

1. 修正UserEntity的props比较逻辑 #

将List字段转换为不可变列表，确保内容变化时引用也同步更新，让Equatable能正确识别差异：

class UserEntity extends Equatable implements Serializable {
  // ... 其他代码不变

  @override
  List<Object> get props {
    return [
      email,
      List.unmodifiable(events), // 转为不可变列表，强制引用更新
      name,
      List.unmodifiable(reports),
      id,
    ];
  }
}

2. 确保Repository返回全新的UserEntity实例 #

在Firestore流映射时，为List字段创建新实例，避免复用旧引用：

Stream<UserEntity> getDocumentStream(String path) {
  return FirebaseFirestore.instance
      .doc(path)
      .snapshots()
      .map((snapshot) {
        final data = snapshot.data()!;
        return UserEntity(
          email: data['email'],
          events: List<String>.from(data['events']), // 新建List实例
          name: data['name'],
          reports: List<String>.from(data['reports']), // 新建List实例
          id: snapshot.id,
        );
      });
}

3. 验证流的事件发射 #

在Bloc的流监听回调中添加日志，确认点击按钮后是否收到新数据：

_userRepository
    .getDocumentStream('${FirestoreConstants.userCollection}/${currentUser.id}')
    .listen((event) {
  print('新用户数据: ${event.events}'); // 打印确认是否收到更新
  add(PageHomeGetUserDataEmitEvent(event));
});

如果无日志输出，需检查Firestore更新逻辑是否正确触发了文档快照变化（比如是否使用了正确的更新方法，而非未生效的操作）。

4. 确认UI正确监听状态 #

确保UI层使用BlocBuilder/BlocConsumer正确监听PageHomeState，并直接使用state.userData的属性：

BlocBuilder<PageHomeBloc, PageHomeState>(
  builder: (context, state) {
    return Text('已参与事件: ${state.userData.events.join(', ')}');
  },
)

避免在UI层缓存userData的旧值，确保每次状态更新都读取最新数据。

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