Flutter应用在iOS模拟器仅显示黑屏问题求助（Bloc+GetIt）

核心问题定位 #

从你的描述和代码来看，应用停留在SplashPage且未触发BlocListener的页面跳转，说明AuthenticationBloc未发送预期的状态更新，或iOS平台存在异步阻塞/渲染冲突问题。以下是针对性解决方案：

1. 修复AuthenticationRepository的同步阻塞问题 #

你在注册AuthenticationRepository时使用了..user.first，这会同步阻塞线程等待Stream的第一个值，在iOS平台可能导致后续Bloc初始化停滞：

// app_initializer.dart 原代码（存在问题）
getIt.registerSingleton(AuthenticationRepository()..user.first);

修改方案：移除同步取值操作，改为在Bloc内部监听用户流：

// app_initializer.dart 修正后
static void _registerSingletons() {
  getIt.registerSingleton(AuthenticationRepository()); // 移除..user.first
  getIt.registerLazySingleton<UserRepository>(() => UserRepository());
}

// AuthenticationBloc 构造函数补充监听逻辑
class AuthenticationBloc extends Bloc<AuthenticationEvent, AuthenticationState> {
  final AuthenticationRepository _authenticationRepository;
  StreamSubscription? _userSubscription;

  AuthenticationBloc({required AuthenticationRepository authenticationRepository}) 
      : _authenticationRepository = authenticationRepository,
        super(const AuthenticationState(authStatus: AuthenticationStatus.unknown)) {
    on<AuthenticationStatusChanged>(_onAuthenticationStatusChanged);
    // 监听用户流，自动触发状态更新
    _userSubscription = _authenticationRepository.user.listen(
      (user) => add(AuthenticationStatusChanged(
        user != null ? AuthenticationStatus.authenticated : AuthenticationStatus.unauthenticated,
      )),
    );
  }

  void _onAuthenticationStatusChanged(
    AuthenticationStatusChanged event,
    Emitter<AuthenticationState> emit,
  ) {
    emit(AuthenticationState(authStatus: event.status));
  }

  @override
  Future<void> close() {
    _userSubscription?.cancel();
    return super.close();
  }
}

2. 调整Firebase初始化顺序 #

iOS平台上Firebase Messaging的后台回调注册可能阻塞主线程，调整初始化顺序避免干扰Bloc启动：

// main.dart 修正后
void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp(
    options: DefaultFirebaseOptions.currentPlatform,
  );
  
  // 先初始化App依赖，再注册后台消息回调
  AppInitializer.init();
  FirebaseMessaging.onBackgroundMessage(_firebaseMessagingBackgroundHandler);
  
  runApp(App());
}

3. 排查SplashPage渲染冲突 #

日志显示dynamic_color未生效，可能暗黑模式下Scaffold背景色与加载指示器颜色重合，导致视觉上的"黑屏"：

// splash_page.dart 显式指定背景色
@override
Widget build(BuildContext context) {
  return Scaffold(
    backgroundColor: Theme.of(context).scaffoldBackgroundColor, // 强制绑定主题背景色
    body: const Center(
      child: CircularProgressIndicator.adaptive(strokeWidth: 5),
    ),
  );
}

也可以临时将AppView中的themeMode改为ThemeMode.light，排除暗黑模式的渲染问题。

4. 确保Bloc触发初始状态检查 #

若Bloc未主动触发状态检查，可在App启动时添加初始化事件：

// App类的构造函数中补充
App({Key? key}) : super(key: key) {
  // 触发Bloc检查当前认证状态
  _authenticationBloc.add(AuthenticationCheckRequested());
}

// AuthenticationBloc中添加事件处理
on<AuthenticationCheckRequested>((event, emit) {
  final user = _authenticationRepository.user.valueOrNull;
  emit(AuthenticationState(
    authStatus: user != null 
        ? AuthenticationStatus.authenticated 
        : AuthenticationStatus.unauthenticated,
  ));
});

快速排查步骤 #

1. 在SplashPage的build方法中添加print("SplashPage rendered")，确认页面是否正常渲染；
2. 在AuthenticationBloc的状态变更处添加print日志，检查iOS平台是否有状态输出；
3. 临时注释Firebase相关代码，验证是否是Firebase初始化导致的阻塞；
4. 检查iOS模拟器的网络权限，确保Firebase能正常连接。

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