Flutter Firebase初始化报错：未创建[DEFAULT]应用

问题描述 #

跟随教程编写的Flutter代码中，已在FutureBuilder的future参数中调用Firebase.initializeApp，但在ConnectionState.done分支中执行print(FirebaseAuth.instance.currentUser)时触发以下异常：

[core/no-app] No Firebase App '[DEFAULT]' has been created - call Firebase.initializeApp()

注释该打印语句后，应用可正常显示"Done"文本。

原因分析 #

1. 重复初始化冲突：build方法会被Flutter框架多次调用，每次调用都会重新执行Firebase.initializeApp()，导致Firebase初始化流程混乱——即使FutureBuilder显示connectionState.done，实际初始化可能并未完全完成或出现重复初始化的冲突。
2. 未处理初始化错误：代码未判断snapshot.hasError状态，若Firebase初始化失败，仍会进入done分支尝试访问FirebaseAuth，引发异常。

解决方案 #

方案一：在main函数中完成Firebase初始化（官方推荐） #

确保App启动前Firebase已完全初始化，从根源避免初始化时序问题：

import 'package:firebase_core/firebase_core.dart';
import 'package:flutter/material.dart';
import 'package:firebase_auth/firebase_auth.dart';
import 'package:mynotes/firebase_options.dart';
import 'package:mynotes/views/login_view.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  // 先完成Firebase初始化，再启动App
  await Firebase.initializeApp(
    options: DefaultFirebaseOptions.currentPlatform,
  );
  runApp(
    MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.green,
      ),
      home: const HomePage(),
    ),
  );
}

class HomePage extends StatelessWidget {
  const HomePage({Key? key}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Home'),
      ),
      body: Center(
        child: Text('当前用户: ${FirebaseAuth.instance.currentUser?.uid ?? "未登录"}'),
      ),
    );
  }
}

方案二：在StatefulWidget中缓存初始化Future #

若必须在页面内完成初始化，使用StatefulWidget的initState缓存初始化Future，避免build方法重复调用初始化：

import 'package:firebase_core/firebase_core.dart';
import 'package:flutter/material.dart';
import 'package:firebase_auth/firebase_auth.dart';
import 'package:mynotes/firebase_options.dart';
import 'package:mynotes/views/login_view.dart';

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  runApp(
    MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.green,
      ),
      home: const HomePage(),
    ),
  );
}

class HomePage extends StatefulWidget {
  const HomePage({Key? key}) : super(key: key);

  @override
  State<HomePage> createState() => _HomePageState();
}

class _HomePageState extends State<HomePage> {
  // 缓存初始化Future，避免build重复调用
  late final Future<FirebaseApp> _firebaseInitialization;

  @override
  void initState() {
    super.initState();
    _firebaseInitialization = Firebase.initializeApp(
      options: DefaultFirebaseOptions.currentPlatform,
    );
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Home'),
      ),
      body: FutureBuilder(
        future: _firebaseInitialization,
        builder: (context, snapshot) {
          // 处理初始化错误
          if (snapshot.hasError) {
            return const Text('Firebase初始化失败，请检查配置');
          }
          switch (snapshot.connectionState) {
            case ConnectionState.done:
              print(FirebaseAuth.instance.currentUser);
              return const Text('Done');
            default:
              return const Text('Loading...');
          }
        },
      ),
    );
  }
}

关键注意事项 #

• 禁止在build方法中直接创建Firebase.initializeApp的Future，避免重复初始化引发的状态冲突。
• 必须处理snapshot.hasError状态，防止初始化失败时触发后续服务访问异常。
• 优先选择方案一的全局初始化方式，这是Firebase官方推荐的最佳实践。

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