Flutter多Firebase环境切换：iOS端部署异常求助

核心问题定位 #

• Bundle ID冲突：开发、生产Firebase项目共用同一个com.myapp.prod Bundle ID是关键隐患——Firebase iOS SDK会根据Bundle ID匹配项目配置，重复ID会导致初始化时无法正确识别目标项目，直接引发崩溃。
• 文件替换不彻底/时机错误：GitHub Actions中直接替换文件后，Xcode缓存的旧配置未被清理，导致构建时仍使用旧的Firebase配置。
• 配置文件不匹配：firebase_options.dart、GoogleService-Info.plist、firebase.json三者必须严格对应同一环境，任何不匹配都会导致初始化失败。

分步解决方案 #

1. 修复Bundle ID冲突 #

• 给开发环境的iOS应用设置独立的Bundle ID，比如com.myapp.dev，生产环境保留com.myapp.prod
• 分别在两个Firebase项目中更新对应iOS应用的Bundle ID，重新下载最新的GoogleService-Info.plist

2. 优化GitHub Actions的文件替换流程 #

在替换配置文件前，先清理Xcode和Flutter的缓存，确保新配置生效：

- name: Clean Flutter & Xcode cache
  run: |
    flutter clean
    rm -rf ios/Pods ios/Podfile.lock ios/Runner.xcworkspace
    pod install --project-directory=ios

- name: Replace Firebase config files
  run: |
    # 替换GoogleService-Info.plist
    mv ./firebase_config/${{ secrets.ENVIRONMENT }}/GoogleService-Info.plist ios/Runner/GoogleService-Info.plist
    # 替换firebase.json
    rm -f ./firebase.json
    mv ./firebase_config/${{ secrets.ENVIRONMENT }}/firebase.json ./firebase.json
    # 替换firebase_options.dart
    rm -f ./lib/firebase_options.dart
    mv ./firebase_config/${{ secrets.ENVIRONMENT }}/firebase_options.dart ./lib/firebase_options.dart

3. 确保Firebase初始化逻辑正确 #

• 不要在main.dart中通过.env动态选择配置文件，而是直接使用当前环境的firebase_options.dart（CI流程已替换该文件）
• 初始化代码保持简洁：

import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';

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

4. 修复Xcode构建阶段的配置问题 #

如果使用Scheme区分环境，确保每个Scheme对应的Build Configuration正确关联配置文件：

• 在Xcode中打开ios/Runner.xcworkspace
• 进入Runner target的Build Phases，添加Run Script阶段，内容为：

ENV="${CONFIGURATION}"
cp "${PROJECT_DIR}/../firebase_config/${ENV}/GoogleService-Info.plist" "${BUILT_PRODUCTS_DIR}/${PRODUCT_NAME}.app/GoogleService-Info.plist"

• 注意：CONFIGURATION对应你的Scheme配置（比如Debug对应dev，Release对应prod）

崩溃日志分析补充 #

你提供的崩溃日志显示异常来自FirebaseCore初始化阶段，这直接验证了配置不匹配或Bundle ID冲突的问题——Firebase SDK无法找到与当前应用Bundle ID匹配的项目配置，因此抛出异常终止应用。

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