Flutter中HydratedBloc已初始化仍报存储未初始化错误求助

错误信息 #

Storage was accessed before it was initialized.
Please ensure that storage has been initialized.

For example:

final storage = await HydratedStorage.build();
HydratedBlocOverrides.runZoned(
() => runApp(MyApp()),
storage: storage,
);

问题分析 #

你提供的main函数初始化逻辑符合HydratedBloc的规范，但仍触发错误，大概率和FavouritesBloc的实现有关，而非MultiBlocProvider/MultiRepositoryProvider的使用方式。

可能的原因及解决办法 #

1. FavouritesBloc未继承HydratedBloc

要实现数据持久化，你的Bloc必须继承HydratedBloc（而非普通Bloc），并强制实现fromJson和toJson方法来完成状态的序列化与反序列化。

正确的Bloc结构示例：

class FavouritesBloc extends HydratedBloc<FavouritesEvent, FavouritesState> {
  final FavouritesRepository repository;

  FavouritesBloc(this.repository) : super(FavouritesInitial()) {
    on<AddFavourites>(_handleAddFavourites);
  }

  void _handleAddFavourites(AddFavourites event, Emitter<FavouritesState> emit) {
    // 处理添加收藏的业务逻辑
  }

  @override
  FavouritesState? fromJson(Map<String, dynamic> json) {
    // 从JSON恢复状态
    return FavouritesState.fromJson(json);
  }

  @override
  Map<String, dynamic>? toJson(FavouritesState state) {
    // 将状态转换为JSON
    return state.toJson();
  }
}

2. Bloc构造函数提前访问Storage

检查FavouritesBloc的构造函数或初始状态逻辑，确保没有在调用super()之前执行任何访问Hydrated Storage的操作——此时Storage尚未完成初始化，会触发错误。

3. 依赖包版本不兼容

确认hydrated_bloc与hydrated_storage的版本匹配，建议升级到最新稳定版，避免版本差异导致的初始化逻辑失效。

排查步骤 #

• 验证FavouritesBloc的继承关系，确认是HydratedBloc子类
• 检查fromJson/toJson方法是否正确实现
• 排查Bloc构造函数中是否存在提前访问Storage的代码
• 升级相关依赖包到最新稳定版本

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