Flutter中MultiBlocProvider过多导致StackOverflow的临时解决方案

针对主应用中一次性提供近百个BLoC引发的StackOverflow问题，以下是几个无需大规模重构的临时解决办法：

1. 拆分MultiBlocProvider层级 #

将原本集中在单个MultiBlocProvider的数百个BlocProvider拆分为多层嵌套的MultiBlocProvider。单个MultiBlocProvider处理的providers数量过多时，会因递归创建逻辑导致栈深度超标，拆分后可降低单次递归的压力。

示例代码：

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MultiBlocProvider(
      providers: [
        BlocProvider(create: (context) => BlocA()),
        BlocProvider(create: (context) => BlocB()),
        // 第一组20-30个BLoC
      ],
      child: MultiBlocProvider(
        providers: [
          BlocProvider(create: (context) => BlocC()),
          BlocProvider(create: (context) => BlocD()),
          // 第二组20-30个BLoC
        ],
        child: MultiBlocProvider(
          providers: [
            // 后续分组，每组控制在30个以内
          ],
          child: MaterialApp.router(/* ... */)
        ),
      ),
    );
  }
}

2. 预初始化部分BLoC并通过value传入 #

将部分BLoC的初始化逻辑从BlocProvider.create移到main函数中，再通过BlocProvider.value传入。这样可以把Widget树构建阶段的创建压力转移到应用启动阶段，避免栈溢出。

示例代码：

void main() async {
  HydratedBloc.storage = await HydratedStorage.build(
    storageDirectory: kIsWeb
        ? HydratedStorage.webStorageDirectory
        : await getApplicationDocumentsDirectory(),
  );
  
  // 预初始化核心BLoC
  final blocA = BlocA();
  final blocB = BlocB();
  
  runApp(MyApp(blocA: blocA, blocB: blocB));
}

class MyApp extends StatelessWidget {
  final BlocA blocA;
  final BlocB blocB;

  const MyApp({super.key, required this.blocA, required this.blocB});

  @override
  Widget build(BuildContext context) {
    return MultiBlocProvider(
      providers: [
        BlocProvider.value(value: blocA),
        BlocProvider.value(value: blocB),
        // 剩余BLoC仍使用create，或拆分到嵌套的MultiBlocProvider
        BlocProvider(create: (context) => BlocC()),
        BlocProvider(create: (context) => BlocD()),
      ],
      child: MaterialApp.router(/* ... */)
    );
  }
}

3. 启用延迟加载优化非核心BLoC #

对于非应用启动时必需的全局BLoC，确保BlocProvider的lazy参数保持默认的true（默认即为延迟加载，仅在首次访问时创建实例）。如果部分BLoC因HydratedBloc特性需要提前加载，可将非核心的HydratedBloc改为延迟初始化，或在其构造函数中异步加载存储数据，避免同步操作占用过多栈空间。

示例：

// 延迟初始化的HydratedBloc示例
class BlocX extends HydratedBloc<XEvent, XState> {
  BlocX() : super(XInitial()) {
    // 异步加载存储数据，避免同步操作阻塞栈
    on<LoadStoredData>((event, emit) async {
      final data = await loadFromStorage();
      emit(XLoaded(data));
    });
    add(LoadStoredData());
  }
  
  // ...其他逻辑
}

4. 检查BLoC构造函数中的同步操作 #

排查是否有BLoC的构造函数中存在大量同步计算、递归调用或嵌套创建其他BLoC的逻辑，这些操作会加剧栈压力。将此类操作移到onCreate回调或异步方法中，减少构造阶段的栈占用。

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