Flutter Firebase Storage报[core/no-app]默认Firebase应用未创建错误

API 探路者

2026-8-26

问题成因

Firebase.initializeApp()是异步返回Future的方法，你在main函数中调用时未添加await关键字，应用启动执行runApp时Firebase默认实例还未完成初始化，全局不存在[DEFAULT] Firebase App。
你在页面顶层提前声明并初始化了final Storage storage = Storage();，该对象的初始化时机早于Firebase初始化完成的节点，Storage类实例化时会立刻调用FirebaseStorage.instance获取存储实例，此时默认Firebase App未创建，直接抛出[core/no-app]异常。
额外风险：你同时导入了官方firebase_core的Firebase SDK和firedart包，两个包存在同名Firebase类，若导包不加前缀极易出现调用错SDK初始化方法的问题。

修复方案

修正main函数中的Firebase初始化逻辑，添加await确保初始化完成后再启动应用：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  // 等待Firebase初始化完成
  await Firebase.initializeApp();
  runApp(const MyApp());
}

调整Storage实例的初始化时机，避免提前触发Firebase实例获取，两种方案可任选其一：

方案1：移除页面顶层的final Storage storage = Storage();声明，在点击上传按钮的逻辑中按需初始化实例：

onPressed: () async {
  // ...省略原有文件选择逻辑
  final path = results.files.single.path!;
  final fileName = results.files.single.name;
  // 用到的时候再初始化Storage
  final Storage storage = Storage();
  storage.uploadFile(path, fileName);
},

方案2：将Storage改造为延迟初始化的单例，避免实例化时过早调用Firebase SDK：

class Storage {
  // 单例构造
  Storage._internal();
  static final Storage instance = Storage._internal();

  // 延迟初始化存储实例，第一次调用上传方法时才真正创建
  late final FirebaseStorage _storage = FirebaseStorage.instance;

  Future<void> uploadFile(String filePath, String fileName) async {
    File file = File(filePath);
    try {
      await _storage.ref(fileName).putFile(file);
    } catch (e) {
      print(e);
    }
  }
}

使用时直接调用Storage.instance.uploadFile(path, fileName)即可，无需提前实例化。

处理导包冲突，给firedart添加导入前缀，避免和官方Firebase SDK的类混淆：

// 修改firedart的导入，添加前缀
import 'package:firedart/firedart.dart' as fd;

后续调用firedart的能力时统一加fd.前缀即可，例如fd.FirebaseAuth等，避免和官方SDK的Firebase类重名导致的初始化逻辑错误。

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