Ionic Capacitor iOS构建报错：'Firebase.h'未找到及后续问题求助

1. 回滚手动修改的插件代码 #

你之前手动修改了FCMPlugin.m和AppDelegate+FCMPlugin.m的代码，这会导致插件与依赖版本不兼容，先恢复这些修改：

• 将#import "Firebase.h"改回#import <Firebase.h>
• 取消对FIRInstanceID相关代码的注释（嫌麻烦的话，直接删除iOS平台重新生成更稳妥）

2. 彻底清理构建缓存与依赖 #

无改动编译失败大概率是缓存或依赖冲突，按顺序执行以下操作：

• 在项目根目录执行：

  ionic capacitor clean ios
  rm -rf ios/Pods ios/Podfile.lock ios/build
  rm -rf node_modules package-lock.json
  npm install
  

• 进入iOS目录重新安装Pods：

  cd ios
  pod install --repo-update
  

3. 替换为兼容Capacitor的Firebase插件 #

你用的CordovaPluginFcmWithDependecyUpdated可能和Capacitor3版本不匹配，建议换用官方支持的插件：

• 卸载旧插件：

  npm uninstall cordova-plugin-fcm-with-dependecy-updated
  

• 安装Capacitor Firebase Messaging插件：

  npm install @capacitor-firebase/messaging
  npx cap sync ios
  

  注意：要确保插件版本适配Capacitor3，可查看插件package.json里的peerDependencies确认。

4. 验证Firebase配置与依赖链接 #

• 确认GoogleService-Info.plist已放在ios/App/App目录下，且在Xcode中已添加到项目（右键项目→Add Files to "App"→选中文件，勾选"Copy items if needed"和目标App）
• 检查Xcode的Build Phases→Link Binary With Libraries，确保包含FirebaseCore、FirebaseMessaging、FirebaseAnalytics等框架，缺失的话手动添加：
  1. 点击"+"→"Add Other..."→"Add Files"
  2. 找到ios/Pods/FirebaseAnalytics/Frameworks/FirebaseAnalytics.framework等文件添加

5. 调整Xcode编译设置 #

打开ios/App/App.xcworkspace，进入项目Build Settings：

• 将Always Search User Paths设为YES
• 确认Header Search Paths包含$(inherited)和${PODS_ROOT}/Firebase/CoreOnly/Sources
• 确保Other Linker Flags包含$(inherited)

6. 重新编译 #

完成上述步骤后，在Xcode中执行Clean Build Folder（Cmd+Shift+K），再重新编译（Cmd+B）

如果问题仍存在，需要提供以下信息以便进一步排查：

• package.json中@capacitor/core、@capacitor/ios、Firebase相关插件的版本
• ios/Podfile.lock中Firebase相关依赖的版本
• Xcode完整编译日志（包括依赖加载过程）

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