Flutter跨端应用：Firebase.initializeApp name参数多端适配问题咨询

问题回顾 #

设置Firebase初始化的name参数时，Android/iOS正常运行，但Web端报错：

[core/no-options] Firebase: Need to provide options, when not being deployed to hosting via source..

注释name参数后，Web端正常，但Android/iOS端报错：

flutter: [core/duplicate-app] A Firebase App named "[DEFAULT]" already exists

解决方案 #

方案1：分平台自定义App名称（需自定义name场景） #

通过kIsWeb判断平台，Web端使用默认App（不设置name），Android/iOS端使用自定义name，同时检查App是否已存在避免重复初始化：

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

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  SystemChrome.setPreferredOrientations([DeviceOrientation.portraitUp]);

  try {
    const customAppName = 'name';
    // Web端使用默认App，其他平台使用自定义名称
    final targetAppName = kIsWeb ? '[DEFAULT]' : customAppName;

    // 检查目标App是否已存在
    final appExists = Firebase.apps.any((app) => app.name == targetAppName);
    if (!appExists) {
      await Firebase.initializeApp(
        name: kIsWeb ? null : customAppName,
        options: DefaultFirebaseOptions.currentPlatform,
      );
    }

    runApp(
      MultiProvider(
        providers: [
          // 你的Provider配置
        ],
        child: const MyApp(),
      ),
    );
  } catch (e) {
    print(e.toString());
  }
}

方案2：统一使用默认App（无需自定义name场景） #

如果不需要自定义Firebase App名称，直接检查默认App是否存在，避免重复初始化即可兼容所有平台：

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

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  SystemChrome.setPreferredOrientations([DeviceOrientation.portraitUp]);

  try {
    // 检查默认App是否未初始化
    final defaultAppExists = Firebase.apps.any((app) => app.name == '[DEFAULT]');
    if (!defaultAppExists) {
      await Firebase.initializeApp(
        options: DefaultFirebaseOptions.currentPlatform,
      );
    }

    runApp(
      MultiProvider(
        providers: [
          // 你的Provider配置
        ],
        child: const MyApp(),
      ),
    );
  } catch (e) {
    print(e.toString());
  }
}

原理说明 #

• Web端初始化自定义name的Firebase App时，需要额外配置对应name的options，而默认的DefaultFirebaseOptions通常只适配默认App，因此会触发no-options错误；使用默认App则无需额外配置。
• Android/iOS端出现duplicate-app错误，是因为已有代码（比如第三方依赖）提前初始化了默认Firebase App，通过预检查App是否存在可避免重复初始化。

内容的提问来源于stack exchange，提问作者JAgüero