Flutter项目iOS编译报错：'GoogleMaps/GoogleMaps.h'文件未找到

• 检查iOS端Google Maps SDK集成状态
  进入项目的ios目录，打开Podfile，确认是否包含pod 'GoogleMaps'相关配置。若依赖拉取异常，可尝试指定SDK版本：

  pod 'GoogleMaps', '~> 6.2.0'
  

  执行命令更新并重新安装Pods：

  pod install --repo-update
  

• 校验Xcode Build Settings配置
  打开iOS项目的Xcode工程，进入TARGETS -> 你的项目 -> Build Settings，搜索Header Search Paths，确认包含以下路径并设置为recursive：

  • $(inherited)
  • ${PODS_ROOT}/GoogleMaps/Frameworks
    若缺失则手动添加。

• 验证Google Maps API密钥与配置文件
  检查ios/Runner/Info.plist中是否正确配置API密钥与权限：

  <key>GoogleMapsAPIKey</key>
  <string>你的API密钥</string>
  <key>NSLocationWhenInUseUsageDescription</key>
  <string>需要访问你的位置以显示地图</string>
  

  同时确认Google Cloud控制台已启用Maps SDK for iOS，且API密钥无访问限制。

• 清理Xcode缓存与构建目录
  在Xcode中执行Product -> Clean Build Folder（快捷键Cmd+Shift+K），关闭Xcode后删除ios目录下的Pods文件夹和Podfile.lock，重新执行pod install。

• 检查Flutter与插件版本兼容性
  确认当前Flutter版本与google_maps_flutter ^2.5.3兼容，若存在版本冲突，可尝试升级插件至最新稳定版：

  flutter pub upgrade google_maps_flutter
  

  之后重新执行flutter pub get和pod install。

• Apple Silicon芯片特殊处理
  若使用M1/M2芯片，可通过以下方式解决架构兼容问题：

  1. 右键终端 -> 显示简介 -> 勾选“使用Rosetta打开”，再执行pod install；
  2. 在Podfile开头添加以下配置后重新安装Pods：

     platform :ios, '12.0'
     installer.pod_target_xcconfig = { 'ARCHS[sdk=iphonesimulator*]' => 'x86_64' }
     

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