Flutter iOS发布模式cloud_firestore模块未找到及TestFlight崩溃求助

1. 调整Podfile配置 #

• 在ios/Podfile的target 'Runner' do代码块内添加以下配置，强制使用静态框架并开启模块化头文件：

  use_frameworks! :linkage => :static
  pod 'FirebaseCore', :modular_headers => true
  pod 'FirebaseAuth', :modular_headers => true
  pod 'CloudFirestore', :modular_headers => true
  

• 确认platform :ios指定的版本不低于Firebase插件要求的最低版本（建议至少13.0）

2. 彻底清理缓存并重新构建 #

• 执行以下命令完成深度清理与重建：

  flutter clean
  rm -rf ios/Pods ios/Podfile.lock ios/Runner.xcworkspace
  rm -rf ~/Library/Developer/Xcode/DerivedData
  flutter pub get
  cd ios && pod install --repo-update && cd ..
  flutter build ios --release
  

3. 检查Xcode核心构建设置 #

• 打开Runner.xcworkspace，进入Runner target的Build Settings：
  • 找到*Dead Code Stripping*，设置为NO（避免发布模式下误删Firestore相关代码）
  • 找到*Optimization Level*，临时设置为None [-O0]（排查是否是编译优化导致模块找不到）
  • 确认*Framework Search Paths*包含$(inherited)和$(PROJECT_DIR)/Pods/FirebaseFirestore/Frameworks
• 切换到Build Phases，检查*Embed Frameworks*中是否包含Firebase相关框架，且Code Sign On Copy选项已勾选

4. 验证Firebase配置文件完整性 #

• 确认GoogleService-Info.plist已添加到Runner target的Build Phases > Copy Bundle Resources中，且发布（Release）模式的目标已勾选该文件
• 核对GoogleService-Info.plist中的CLIENT_ID、REVERSED_CLIENT_ID等字段，确保与Firebase控制台的iOS应用配置完全一致

5. 定位TestFlight崩溃原因 #

• 打开Xcode的Organizer（路径：Window > Organizer），下载TestFlight的崩溃报告，查看具体崩溃调用栈：
  • 若崩溃发生在Firebase Auth初始化阶段，确认FirebaseApp.configure()已在AppDelegate.swift或main.dart的初始化代码中调用
  • 尝试关闭Bitcode（Build Settings > Enable Bitcode 设置为NO），部分Firebase版本对Bitcode的支持存在兼容问题

6. 版本兼容性排查 #

• 升级Flutter到最新稳定版：flutter upgrade
• 在pubspec.yaml中指定Firebase插件的最新兼容版本，示例：

  firebase_core: ^2.15.0
  firebase_auth: ^4.10.0
  cloud_firestore: ^4.9.0
  

• 升级Xcode到14.3及以上版本，Firebase部分新版本对Xcode版本有明确要求，旧版Xcode可能导致编译或运行时异常

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