Xcode11.5 Flutter项目Release模式构建报错：FirebaseCore头文件缺失

我之前也踩过几乎一模一样的坑——Debug模式跑得顺风顺水，一打包Release就直接炸。结合你给出的所有配置细节，给你几个针对性的解决方案，按顺序试应该能搞定：

方案一：修正Podfile的配置细节 #

你的Podfile里有几个可能触发Release构建失败的点，调整一下：

1. 把全局的use_modular_headers!改成针对性开启，避免依赖冲突：

   target 'Runner' do
     use_frameworks!
     # 替换全局use_modular_headers!为逐个pod开启
     pod 'Flutter', :path => 'Flutter', :modular_headers => true
     # 手动添加Firebase核心依赖，确保Release模式能正确引入
     pod 'Firebase/Core', :modular_headers => true
     # 如果你用了其他Firebase服务，比如Analytics、Auth，也加上对应的pod
     # pod 'Firebase/Analytics', :modular_headers => true
   
     # 插件Pods部分保留，给Firebase相关插件单独开启modular headers
     system('rm -rf .symlinks')
     system('mkdir -p .symlinks/plugins')
     plugin_pods = parse_KV_file('../.flutter-plugins')
     plugin_pods.each do |name, path|
       symlink = File.join('.symlinks', 'plugins', name)
       File.symlink(path, symlink)
       if name.start_with?('firebase_')
         pod name, :path => File.join(symlink, 'ios'), :modular_headers => true
       else
         pod name, :path => File.join(symlink, 'ios')
       end
     end
   end
   

2. 修正Project配置的模式映射，避免Profile和Release混淆：

   project 'Runner', {
     'Debug' => :debug,
     'Profile' => :profile,
     'Release' => :release,
   }
   

方案二：彻底清理缓存，重新构建 #

缓存是这类问题的重灾区，按顺序执行以下命令：

• 清理Flutter和CocoaPods缓存：

  flutter clean
  rm -rf ios/Pods
  rm ios/Podfile.lock
  rm -rf ~/Library/Caches/CocoaPods
  rm -rf ios/Runner.xcworkspace
  

• 重新获取依赖并安装Pods：

  flutter pub get
  cd ios
  pod repo update
  pod install --repo-update
  

• 打开Xcode的Runner.xcworkspace（别用.xcodeproj），切换到Release模式，按Cmd+Shift+K清理Build Folder，再重新构建。

方案三：检查Xcode Release模式的Build Settings #

打开Xcode选中Runner target，切换到Release配置，检查以下项：

• Header Search Paths：确保包含$(inherited)和${PODS_ROOT}/Firebase/CoreOnly，设置为recursive
• Framework Search Paths：同样要包含$(inherited)和${PODS_ROOT}/FirebaseCore
• Build Options：确认Enable Modules (C and Objective-C)设为YES
• Other Linker Flags：确保包含$(inherited)

方案四：匹配Flutter和Firebase插件的版本 #

你的Flutter是1.17.3（较老的稳定版），对应的Firebase插件版本必须兼容，不能用太新的。在pubspec.yaml里指定兼容版本：

dependencies:
  flutter:
    sdk: flutter
  firebase_core: ^0.4.5
  # 其他Firebase插件对应兼容版本，比如firebase_auth: ^0.16.1，可查插件pub.dev页面的兼容说明

修改后执行flutter pub get，再重复方案二的清理步骤。

最后验证 #

完成以上步骤后，先尝试用命令行构建Release包，看是否报错：

flutter build ios --release

如果还有问题，打开Xcode的Report Navigator（左侧最后一个图标），查看详细错误日志，确认是否有其他依赖未正确引入。

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