Flutter构建iOS应用失败：'PigeonParser.h'文件未找到求助

问题描述 #

构建Flutter iOS项目时触发以下错误：

Failed to build iOS app
Lexical or Preprocessor Issue (Xcode): 'PigeonParser.h' file not found
/Users/alehhutnikau/.pub-cache/hosted/pub.dev/firebase_auth-4.11.0/ios/Classes/PigeonParser.m:4:8

Encountered error while archiving for device.

已尝试flutter clean、重新初始化iOS项目，问题仍未解决。

可行解决方案 #

• 清理指定依赖缓存并重新拉取
  直接删除pub缓存中出问题的firebase_auth包，再重新获取依赖：

  rm -rf ~/.pub-cache/hosted/pub.dev/firebase_auth-4.11.0
  flutter pub get
  

  避免缓存文件损坏或缺失导致头文件找不到。

• 检查Xcode的Header Search Paths配置

  1. 打开iOS目录下的Runner.xcworkspace
  2. 选中Runner目标，进入Build Settings标签页
  3. 搜索Header Search Paths，确认包含以下路径并设置为recursive：

     $(inherited)
     $(PROJECT_DIR)/Flutter
     $(PODS_ROOT)/Headers/Public
     

  确保Xcode能递归搜索到依赖库的头文件。

• 升级firebase_auth到最新稳定版
  修改pubspec.yaml中firebase_auth的版本号为pub.dev上的最新稳定版，执行flutter pub upgrade firebase_auth，新版本可能修复了头文件缺失的问题。

• 彻底重置CocoaPods依赖
  进入iOS目录执行以下命令：

  pod deintegrate
  pod install
  

  完全清理现有Pods后重新安装，保证iOS依赖库文件完整。

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