iOS版Firebase集成示例(FriendlyPix)编译报错：找不到FirebaseAuthUI模块

我之前也碰到过类似的Firebase CocoaPods模块找不到的问题，尤其是在官方示例项目里偶尔会出现这种情况，给你几个亲测有效的排查和解决步骤：

1. 重新安装CocoaPods（优先尝试） #

有时候pod update会拉取不兼容的版本，或者Pods安装过程中出现缓存问题，建议完全重置Pods后重新安装：

• 先删除项目目录下的Pods文件夹和Podfile.lock文件
• 打开终端，进入项目根目录，执行命令：

  rm -rf Pods Podfile.lock
  pod install
  

  注意：这里用pod install而不是pod update，因为官方示例项目的Podfile通常已经指定了兼容的依赖版本，直接安装更稳妥。

2. 确认打开的是正确的项目文件 #

这是最容易忽略的点：必须打开FriendlyPix.xcworkspace而不是FriendlyPix.xcodeproj。如果打开的是.xcodeproj，Xcode不会加载CocoaPods安装的框架，自然找不到FirebaseAuthUI模块。

3. 检查Build Settings中的框架搜索路径 #

FirebaseAuthUI是框架文件，需要确保Framework Search Paths配置正确：

• 在Xcode中选中项目 -> 选择目标Target -> 切换到Build Settings标签
• 搜索Framework Search Paths，确保包含以下路径（且$(inherited)排在最前面）：

  $(inherited)
  ${PODS_ROOT}/FirebaseAuthUI
  ${PODS_ROOT}/FirebaseAuth
  ${PODS_ROOT}/FirebaseCore
  

  $(inherited)非常重要，CocoaPods会自动配置所有Pods的框架路径，手动删除这个会导致路径缺失。

4. 清理项目缓存 #

Xcode的缓存有时候会导致奇怪的编译问题，建议彻底清理：

• 按下Cmd+Shift+K清理当前项目的Build文件夹
• 清理Derived Data：打开Xcode -> 顶部菜单栏Xcode -> Settings -> Locations -> 点击Derived Data右侧的箭头，打开文件夹后删除当前项目对应的文件夹
• 重启Xcode后再尝试编译

5. 确认Podfile的iOS版本兼容 #

检查项目根目录的Podfile，确认开头的platform :ios版本和项目的部署目标一致。比如FriendlyPix项目通常要求iOS 13.0及以上，如果你的项目部署目标低于这个版本，Pods可能无法正确安装对应框架：

platform :ios, '13.0'

修改后重新执行pod install。

6. 指定FirebaseAuthUI的具体版本 #

如果以上步骤都无效，可以尝试在Podfile中指定FirebaseAuthUI的具体兼容版本，比如：

pod 'FirebaseAuthUI', '~> 12.0'

选择一个和项目其他Firebase依赖兼容的版本（可以参考项目的README或者Firebase官方文档），然后重新执行pod install。

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