iOS项目报'FirebaseMessaging.h' file not found错误如何解决？

按以下优先级排查修复：

• 首先确认打开的项目文件正确：执行pod install后必须关闭所有Xcode窗口，打开项目根目录下后缀为.xcworkspace的文件启动项目，不要打开旧的.xcodeproj文件，否则CocoaPods管理的依赖不会被加载到编译链路里。
• 校验Podfile配置正确性：
  打开项目根目录的Podfile，确认Firebase/Messaging依赖写在你当前编译的主Target块内，参考正确配置：

  # 顶部source要和你项目其他依赖的源保持一致，不要混源
  target '你的项目实际Target名称' do
    # 根据你项目配置决定是否开启use_frameworks!，不要和其他依赖配置冲突
    pod 'Firebase/Messaging'
  end
  

  配置确认无误后，清缓存重装依赖，终端cd到项目根目录依次执行以下命令：

  pod deintegrate
  rm -rf Pods Podfile.lock
  pod cache clean Firebase --all
  pod install
  

• 清理Xcode编译缓存：
  重装依赖后打开Xcode，按快捷键Command+Shift+K执行Clean Build Folder，再打开访达按Command+Shift+G输入路径~/Library/Developer/Xcode/DerivedData，删除和你项目同名的缓存文件夹，重启Xcode再编译。
• 校验头文件引用与编译配置：
  • OC项目：引用FirebaseMessaging头文件时使用三方库标准引用格式#import <FirebaseMessaging/FirebaseMessaging.h>，不要用双引号引用；打开对应Target的Build Settings，找到Header Search Paths项，确认配置了$(inherited)和$(SRCROOT)/Pods/Headers/Public，对应选项设为recursive，所有Pods相关的配置项不要手动修改，确保继承CocoaPods生成的配置。
  • Swift项目：不要直接在Swift代码里导入OC头文件，先配置正确的OC桥接文件，在桥接文件里按上述尖括号格式引入FirebaseMessaging头文件，再在Swift代码里用import FirebaseMessaging调用即可。
• 特殊架构场景修复：
  如果你使用M系列芯片的Mac，检查Xcode和终端是否开启了Rosetta转译，关闭Rosetta后重新执行pod install，架构混跑会导致CocoaPods生成的头文件路径匹配错误，触发文件找不到的报错。

排查验证技巧：重装依赖后打开Pods目录，依次进入Headers/Public/FirebaseMessaging路径，确认目录下存在FirebaseMessaging.h文件。如果文件不存在，属于依赖下载损坏，重新走清缓存重装流程即可；如果文件存在，100%是Xcode头文件搜索路径配置错误，回到编译配置项逐一核对即可。

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