返回导航时Page/BlocBuilder无日志却异常重建问题

你遇到的核心问题是：导航返回原页面时，所有关联Widget重建，但Bloc本身并未触发新状态发射。结合你的代码和现象，根源在于**RestaurantsCubit的BlocProvider被放置在当前页面的build方法内部**，导致页面重建时（比如导航返回），BlocProvider被重新创建，进而触发整个子Widget树重建。

具体原因 #

BlocProvider基于InheritedWidget实现，若在页面build方法内创建它：

1. 每次页面build触发（导航返回可能触发页面重建），都会重新执行create方法生成新的BlocProvider实例
2. BlocProvider作为父Widget，其实例变化会强制所有子Widget（包括静态Widget和BlocBuilder）重建
3. 即便sl返回单例Cubit，BlocProvider的重建依然会触发子树更新

解决方案 #

方案1：将BlocProvider移到路由层级 #

把BlocProvider放在路由配置中，而非页面的build方法内，确保BlocProvider仅在页面初始化时创建一次：

// 路由配置示例
MaterialApp(
  routes: {
    '/restaurant_page': (context) => BlocProvider<RestaurantsCubit>(
          create: (_) => sl<RestaurantsCubit>()..getRestaurants(),
          child: YourRestaurantPage(),
        ),
  },
)

方案2：在StatefulWidget的initState中初始化Cubit #

如果必须在页面内创建BlocProvider，结合StatefulWidget的生命周期初始化Cubit，再通过BlocProvider.value传递：

class YourRestaurantPage extends StatefulWidget {
  @override
  State<YourRestaurantPage> createState() => _YourRestaurantPageState();
}

class _YourRestaurantPageState extends State<YourRestaurantPage> {
  late RestaurantsCubit _restaurantsCubit;

  @override
  void initState() {
    super.initState();
    // 仅在页面初始化时创建一次Cubit
    _restaurantsCubit = sl<RestaurantsCubit>()..getRestaurants();
  }

  @override
  void dispose() {
    _restaurantsCubit.close();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return BlocProvider.value(
      value: _restaurantsCubit,
      child: Scaffold(
        body: Column(
          // 你的子Widget
        ),
      ),
    );
  }
}

方案3：检查依赖注入配置 #

确保sl（get_it）中RestaurantsCubit的注册是单例模式，避免每次调用sl<RestaurantsCubit>()生成新实例：

// get_it注册示例
sl.registerSingleton<RestaurantsCubit>(RestaurantsCubit());
// 而非registerFactory，后者每次调用都会生成新实例
// sl.registerFactory<RestaurantsCubit>(() => RestaurantsCubit());

验证方法 #

你可以在BlocProvider的create方法中添加打印日志，确认导航返回时是否被重复调用：

BlocProvider<RestaurantsCubit>(
  create: (_) {
    print('RestaurantsCubit created');
    return sl<RestaurantsCubit>()..getRestaurants();
  },
)

如果返回页面时该日志被触发，说明确实是BlocProvider重复创建导致的问题。

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