Flutter电商项目中firebase.initializeApp()初始化失败问题

核心原因 #

Web平台无法自动读取本地配置文件，必须手动传入FirebaseOptions参数；Android/iOS若配置正确可自动加载，但Web端需显式配置。

具体解决步骤 #

1. 获取Web平台Firebase配置信息 #

• 打开Firebase控制台进入目标项目
• 点击左侧「项目设置」，滚动到「你的应用」区域，找到对应Web应用（未创建则点击「添加应用」选择Web类型）
• 复制代码块内firebaseConfig对象的所有字段，包含apiKey、authDomain、projectId、storageBucket等

2. 在main.dart中配置FirebaseOptions #

修改初始化代码，可通过平台自动适配或手动指定配置：

方式一：使用默认平台配置（推荐）

import 'package:firebase_core/firebase_core.dart';
import 'package:flutter/foundation.dart';
import 'package:flutter/material.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  await Firebase.initializeApp(
    options: DefaultFirebaseOptions.currentPlatform,
  );
  
  runApp(const MyApp());
}

方式二：手动传入Web配置

import 'package:firebase_core/firebase_core.dart';
import 'package:flutter/material.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  await Firebase.initializeApp(
    options: const FirebaseOptions(
      apiKey: "你的apiKey",
      authDomain: "你的authDomain",
      projectId: "你的projectId",
      storageBucket: "你的storageBucket",
      messagingSenderId: "你的messagingSenderId",
      appId: "你的appId",
      measurementId: "你的measurementId" // 无此配置可省略
    ),
  );
  
  runApp(const MyApp());
}

3. 验证Android/iOS配置正确性 #

• Android：确认google-services.json放在android/app目录下，且两处build.gradle已配置Google服务插件：
  • 项目级build.gradle：添加classpath 'com.google.gms:google-services:4.3.15'
  • App级build.gradle：底部添加apply plugin: 'com.google.gms.google-services'
• iOS：确认GoogleService-Info.plist放在ios/Runner目录下，且已通过Xcode右键Runner选择「Add Files to "Runner"」添加到项目

4. 清理并重新构建 #

执行以下命令更新依赖与缓存：

flutter clean
flutter pub get
flutter run

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