Flutter中如何在应用内切换多个Firebase项目/环境？

AI 小北

2026-5-8

在Flutter应用内切换Firebase项目/环境的实现方案

当然可以搞定这个需求！而且现在Firebase官方已经正式支持在单个Flutter应用内切换不同项目/环境了，完全不用再折腾多个构建版本或者提交多个TestFlight包，太方便了～

核心思路

Firebase允许在单个应用中初始化多个FirebaseApp实例，每个实例对应一个独立的Firebase项目（开发、测试、生产等）。我们只需要提前准备好各环境的配置，通过用户操作（比如下拉菜单）触发对应实例的初始化，之后使用Firebase服务时指定对应的实例即可。

具体实现步骤

1. 准备多环境的Firebase配置

每个Firebase项目都有专属的FirebaseOptions配置参数，你可以从项目控制台获取：

进入对应Firebase项目的控制台 → 项目设置 → 向下滚动到"您的应用"区域
复制对应平台（Android/iOS/Web）的配置参数，整理成FirebaseOptions对象，存在本地的配置映射里：

final Map<String, FirebaseOptions> firebaseEnvConfigs = {
  '开发环境': FirebaseOptions(
    apiKey: '你的开发环境API_KEY',
    appId: '你的开发环境APP_ID',
    projectId: '你的开发环境PROJECT_ID',
    messagingSenderId: '你的开发环境SENDER_ID',
    storageBucket: '你的开发环境STORAGE_BUCKET',
    // 根据需求补充其他参数，比如databaseURL等
  ),
  '测试环境': FirebaseOptions(
    apiKey: '你的测试环境API_KEY',
    appId: '你的测试环境APP_ID',
    projectId: '你的测试环境PROJECT_ID',
    messagingSenderId: '你的测试环境SENDER_ID',
    storageBucket: '你的测试环境STORAGE_BUCKET',
  ),
  '生产环境': FirebaseOptions(
    apiKey: '你的生产环境API_KEY',
    appId: '你的生产环境APP_ID',
    projectId: '你的生产环境PROJECT_ID',
    messagingSenderId: '你的生产环境SENDER_ID',
    storageBucket: '你的生产环境STORAGE_BUCKET',
  ),
};

2. 实现环境初始化与切换逻辑

我们可以封装一个初始化方法，用来创建/复用指定环境的FirebaseApp实例：

import 'package:firebase_core/firebase_core.dart';

Future<void> switchFirebaseEnvironment(String envName) async {
  // 检查该环境的实例是否已初始化，避免重复创建
  if (Firebase.apps.any((app) => app.name == envName)) {
    // 已存在则直接使用该实例
    Firebase.app(envName);
    return;
  }
  // 初始化新的FirebaseApp实例
  await Firebase.initializeApp(
    name: envName,
    options: firebaseEnvConfigs[envName]!,
  );
}

你之前找到的FirebaseApp.configure是旧版本的API，现在已经被Firebase.initializeApp替代，但核心逻辑完全一致——通过唯一的name和对应环境的options来区分不同项目实例。

3. 结合UI实现切换（比如下拉菜单）

下面是一个简单的下拉菜单切换示例，包含环境选择和数据测试功能：

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

class FirebaseEnvSwitcher extends StatefulWidget {
  const FirebaseEnvSwitcher({super.key});

  @override
  State<FirebaseEnvSwitcher> createState() => _FirebaseEnvSwitcherState();
}

class _FirebaseEnvSwitcherState extends State<FirebaseEnvSwitcher> {
  String selectedEnv = '开发环境';

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Firebase环境切换')),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            // 环境选择下拉菜单
            DropdownButton<String>(
              value: selectedEnv,
              items: firebaseEnvConfigs.keys
                  .map((env) => DropdownMenuItem(
                        value: env,
                        child: Text(env),
                      ))
                  .toList(),
              onChanged: (newEnv) async {
                if (newEnv != null) {
                  setState(() {
                    selectedEnv = newEnv;
                  });
                  // 切换并初始化对应环境
                  await switchFirebaseEnvironment(newEnv);
                  // 提示用户切换成功
                  if (mounted) {
                    ScaffoldMessenger.of(context).showSnackBar(
                      SnackBar(content: Text('已切换到$newEnv')),
                    );
                  }
                }
              },
            ),
            const SizedBox(height: 20),
            // 测试当前环境的Firestore数据
            ElevatedButton(
              onPressed: () async {
                // 指定使用当前选中环境的FirebaseApp实例
                final firestore = FirebaseFirestore.instanceFor(
                  app: Firebase.app(selectedEnv),
                );
                // 测试获取数据
                final docSnapshot = await firestore.collection('test').doc('sample').get();
                if (mounted) {
                  showDialog(
                    context: context,
                    builder: (context) => AlertDialog(
                      title: Text('$selectedEnv数据'),
                      content: Text(docSnapshot.data().toString()),
                    ),
                  );
                }
              },
              child: const Text('获取当前环境测试数据'),
            ),
          ],
        ),
      ),
    );
  }
}

4. 关键注意事项

使用Firebase服务（Firestore、Auth、Storage等）时，必须通过instanceFor(app: Firebase.app(envName))指定对应的实例，否则会默认使用第一个初始化的实例。
可以把用户选中的环境存在本地存储（比如SharedPreferences），下次应用启动时自动初始化对应的环境，提升体验。
每个FirebaseApp实例的name必须唯一，建议直接用环境名称作为标识。

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