Flutter iOS构建报错：找不到FirebaseCore.h头文件问题求助

排查解决步骤 #

1. 修正Podfile配置 #

打开ios目录下的Podfile，调整全局配置和后置钩子：

• 替换原有use_frameworks!配置为：

use_frameworks! :linkage => :static
use_modular_headers!

• 调整post_install钩子，统一所有Pod的最低iOS版本和架构配置：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    flutter_additional_ios_build_settings(target)
    target.build_configurations.each do |config|
      # Firebase 8+ 最低要求iOS 10，低于该版本会出现头文件引用异常
      config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '10.0'
      # M1芯片Mac需要额外排除模拟器arm64架构避免冲突
      config.build_settings['EXCLUDED_ARCHS[sdk=iphonesimulator*]'] = 'arm64'
    end
  end
end

2. 验证Xcode配置继承关系 #

打开Runner.xcworkspace，进入Runner target的Build Settings页面：

• 搜索Header Search Paths，确认配置项继承了${PODS_ROOT}的递归搜索权限，没有被手动配置覆盖
• 进入Info > Configurations，确认Debug、Release、Profile三个模式的配置文件，都正确指向Pods生成的Pods-Runner.对应模式.xcconfig，没有使用自定义配置导致Pod的头文件搜索规则失效

3. 更新CocoaPods版本与本地仓库 #

旧版本CocoaPods对Firebase新版静态库的解析存在兼容性问题，执行以下命令升级：

sudo gem install cocoapods
pod repo update

升级完成后执行完整清理重构流程：

# 在项目根目录执行
flutter clean
rm -rf ios/Podfile.lock ios/Pods ios/Runner.xcworkspace
flutter pub get
cd ios && pod install --repo-update

4. 对齐Firebase依赖版本 #

你当前使用的firebase_core 1.1.1属于较旧版本，和其他Firebase插件可能存在版本兼容冲突，建议将所有Firebase相关依赖升级到兼容的稳定版本：

firebase_core: 1.24.0
firebase_crashlytics: 2.8.11
firebase_analytics: 9.3.8
firebase_auth: 3.11.2
firebase_remote_config: 2.0.20
firebase_storage: 10.3.11

版本调整后重新执行flutter pub get和pod install即可。

5. 排查架构冲突 #

如果使用M1芯片的Mac，可尝试右键Xcode点击「显示简介」，勾选「使用Rosetta打开」后重新构建；如果是Intel芯片Mac，确认Runner目标的Build Settings > Architectures配置为Standard Architectures (arm64, armv7)，没有手动删除支持架构。

内容的提问来源于stack exchange，提问作者Zalán Meggyesi