BlocSelector中Cubit状态未更新 求助排查问题

在Flutter应用中使用Bloc Cubit存储登录用户信息，通过BlocSelector监听状态以切换HomePage或LoginPage，首次启动正常。登录后在HomePage添加退出登录按钮，调用updateUser(null)将Cubit状态更新为AppUserInitial，但BlocSelector未触发UI切换回LoginPage，请求排查问题。

相关代码 #

main.dart #

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await initDependencies();
  runApp(MultiBlocProvider(providers: [
    BlocProvider(create: (context) => serviceLocator<AppUserCubit>()),
    BlocProvider(
      create: (context) => serviceLocator<AuthBloc>(),
    ),
  ], child: const MyApp()));
}

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

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  @override
  void initState() {
    super.initState();
    serviceLocator<AuthBloc>().add(AuthIsUserLoggedIn());
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      title: 'My App',
      theme: AppTheme.theme,
      home: BlocSelector<AppUserCubit, AppUserState, bool>(
        selector: (state) {
          return state is AppUserLoggedIn;
        },
        builder: (context, state) {
          if (state) {
            return const HomePage();
          }
          return const LoginPage();
        },
      ),
    );
  }
}

AppUserCubit.dart #

class AppUserCubit extends Cubit<AppUserState> {
  final CacheLocalDataSource _cacheLocalDataSource;

  AppUserCubit({required CacheLocalDataSource cacheLocalDataSource})
      : _cacheLocalDataSource = cacheLocalDataSource,
        super(AppUserInitial());

  void updateUser(User? user) async {
    if (user != null) {
      var userModel = UserModel(
          userId: user.userId,
          name: user.name,
          email: user.email,
          description: user.description);

      await _cacheLocalDataSource.cacheUser(userModel);
      emit(AppUserLoggedIn(user: user));
    } else {
      await _cacheLocalDataSource.deleteUser();
      emit(AppUserInitial());
    }
  }
}

HomePage.dart #

class HomePage extends StatelessWidget {
  static route() => MaterialPageRoute(builder: (context) => const HomePage());
  const HomePage({super.key});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Home Page'),
      ),
      drawer: const AppDrawer(),
      body: Center(
        child: ElevatedButton(
            onPressed: () {
              context.read<AppUserCubit>().updateUser(null);
            },
            child: const Text('Home Page')), // 注：此处应为"退出登录"，不影响功能逻辑
      ),
    );
  }
}

可能的原因及解决方法 #

1. 页面切换方式错误：登录时手动跳转而非依赖BlocSelector #

如果登录逻辑中通过Navigator.push手动跳转到HomePage，即使Cubit状态更新，BlocSelector切换到LoginPage，导航栈中仍存在HomePage，导致UI无法回退。

解决：移除登录时的Navigator.push调用，仅在登录成功后调用AppUserCubit.updateUser(user)，让BlocSelector自动根据状态切换页面。

2. AppUserState子类未重写==和hashCode #

Cubit通过对比新旧状态的==结果判断是否触发更新。若未重写状态类的==和hashCode，可能导致状态变化未被识别。

解决：使用equatable包或手动重写方法，确保状态对比正确：

// 依赖equatable包
abstract class AppUserState extends Equatable {}

class AppUserInitial extends AppUserState {
  @override
  List<Object?> get props => [];
}

class AppUserLoggedIn extends AppUserState {
  final User user;

  AppUserLoggedIn({required this.user});

  @override
  List<Object?> get props => [user.userId, user.name, user.email, user.description];
}

3. Cubit实例不唯一 #

若serviceLocator返回的AppUserCubit不是单例，会导致BlocProvider提供的实例与HomePage中获取的实例不一致，状态更新无法同步。

解决：确保依赖注入中注册AppUserCubit为单例（以get_it为例）：

serviceLocator.registerSingleton<AppUserCubit>(
  AppUserCubit(cacheLocalDataSource: serviceLocator<CacheLocalDataSource>())
);

4. BlocSelector未正确触发重建 #

可临时替换为BlocBuilder测试是否能触发更新，排查是否为BlocSelector的问题；或显式设置shouldRebuild参数：

BlocSelector<AppUserCubit, AppUserState, bool>(
  selector: (state) => state is AppUserLoggedIn,
  shouldRebuild: (previous, current) => previous != current,
  builder: (context, isLoggedIn) {
    return isLoggedIn ? const HomePage() : const LoginPage();
  },
)

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