将Firebase初始化移至外部文件后出现未创建Firebase App异常

核心问题根源 #

你的问题并非Firebase配置错误（直接在main.dart调用Firebase.initializeApp能正常运行即可证明），而是AuthService封装时的初始化逻辑存在漏洞：要么是初始化方法未传入DefaultFirebaseOptions，要么是初始化时机未处理好Flutter绑定，导致FirebaseAuth.instance在Firebase App未完成初始化时被调用。

具体修复步骤 #

1. 修正FirebaseAuthProvider的初始化逻辑 #

确保初始化时传入配置参数，并处理重复初始化的情况：

import 'package:firebase_core/firebase_core.dart';
import 'package:firebase_auth/firebase_auth.dart';
import 'firebase_options.dart';

class FirebaseAuthProvider implements AuthService {
  // 单例实现，确保全局只有一个实例
  static final FirebaseAuthProvider _instance = FirebaseAuthProvider._internal();
  factory FirebaseAuthProvider() => _instance;
  FirebaseAuthProvider._internal();

  @override
  Future<void> initialize() async {
    // 避免重复初始化Firebase App
    if (Firebase.apps.isEmpty) {
      await Firebase.initializeApp(
        options: DefaultFirebaseOptions.currentPlatform, // 必须传入配置
      );
    }
  }

  @override
  User? get currentUser => FirebaseAuth.instance.currentUser;
}

2. 确保AuthService工厂方法返回单例 #

import 'package:firebase_auth/firebase_auth.dart';

abstract class AuthService {
  // 返回单例的FirebaseAuthProvider实例
  factory AuthService.firebase() => FirebaseAuthProvider();
  
  Future<void> initialize();
  User? get currentUser;
}

3. 正确的全局初始化时机（main函数） #

之前在main函数中await无效，大概率是缺少WidgetsFlutterBinding.ensureInitialized()，这是Flutter中在runApp前执行异步操作的必要步骤：

import 'package:flutter/material.dart';

void main() async {
  // 初始化Flutter绑定，否则异步操作可能无法正常执行
  WidgetsFlutterBinding.ensureInitialized();
  // 先完成Firebase初始化，再启动App
  await AuthService.firebase().initialize();
  runApp(const MyApp());
}

4. HomePage只负责状态判断，不做初始化 #

把初始化逻辑完全从UI层剥离，HomePage仅根据用户状态跳转：

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

  @override
  Widget build(BuildContext context) {
    final authService = AuthService.firebase();
    // 直接根据currentUser状态跳转
    return authService.currentUser == null 
        ? const LoginPage() 
        : const DashboardPage();
  }
}

如果需要监听用户实时状态变化，改用StreamBuilder：

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

  @override
  Widget build(BuildContext context) {
    return StreamBuilder<User?>(
      stream: FirebaseAuth.instance.authStateChanges(),
      builder: (context, snapshot) {
        if (snapshot.connectionState == ConnectionState.waiting) {
          return const CircularProgressIndicator();
        }
        return snapshot.data == null ? const LoginPage() : const DashboardPage();
      },
    );
  }
}

为什么之前的写法会报错？ #

1. HomePage的FutureBuilder初始化：初始化操作和currentUser访问可能存在竞态，Firebase App还未完成初始化，代码就已经尝试获取currentUser。
2. main函数未加绑定初始化：缺少WidgetsFlutterBinding.ensureInitialized()会导致Flutter异步环境未就绪，await操作无法正确完成。

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