Flutter iOS构建报No such module 'FBSDKCoreKit'错误排查

核心报错信息 #

Uncategorized (Xcode): Command CompileSwift failed with a nonzero exit code

Swift Compiler Error (Xcode): No such module 'FBSDKCoreKit'
/development/flutter/.pub-cache/hosted/pub.dartlang.org/flutter_facebook_auth-4.3.3/ios/Classes/FacebookAuth.swift:8:7
2

Could not build the application for the simulator.
Error launching application on iPhone 12.
Exited (sigterm)

根因说明 #

flutter_facebook_auth属于项目依赖的传递依赖，即pubspec.yaml中声明的某个第三方插件间接引入了该包，并非主动安装。报错本质是该包对应的iOS原生依赖FBSDKCoreKit存在拉取异常、本地缓存损坏、架构匹配错误等问题，常规的flutter clean、普通pod install操作没有清理到全局缓存和错误配置，导致问题反复出现。

分步解决操作 #

• 定位传递依赖来源：在项目根目录执行flutter pub deps，在输出的依赖树中搜索flutter_facebook_auth，即可找到是哪个已安装的插件间接引入了它。如果该插件非项目必需，直接在pubspec.yaml中移除该显式依赖，执行flutter pub get后重新构建即可；如果插件必须保留，继续后续操作。
• 全链路清理缓存（可解决90%以上同类问题）：
  1. 关闭所有Xcode窗口，终止所有正在运行的Flutter调试进程
  2. 项目根目录执行flutter clean，手动删除项目下ios/Pods文件夹、ios/Podfile.lock文件
  3. 执行rm -rf /development/flutter/.pub-cache/hosted/pub.dartlang.org/flutter_facebook_auth-*，删除本地pub缓存中损坏的flutter_facebook_auth包
  4. 进入ios目录执行pod cache clean FBSDKCoreKit --all，清理本地全局缓存的Facebook SDK文件，提示确认时输入y回车
  5. 回到项目根目录执行flutter pub get，再进入ios目录执行pod install --repo-update，等待依赖拉取完成后重新构建
• 修复架构匹配问题：如果清理后仍报xcframework切片匹配相关警告，打开ios/Runner.xcworkspace，选中Runner靶标，在Build Settings中找到Excluded Architectures配置项，为模拟器Debug模式新增arm64排除规则，避免x86_64架构的模拟器错误拉取arm64架构的FBSDKCoreKit依赖。
• 处理其他干扰构建的警告：
  1. flutter_image_compress的未使用变量警告为插件自身代码问题，不影响正常构建，若要消除警告直接将该插件升级到最新稳定版本即可
  2. GoogleService-Info.plist重复构建警告：在Xcode中打开Runner的Build Phases -> Copy Bundle Resources列表，找到重复的GoogleService-Info.plist引用条目，删除重复项即可，不要误删项目中实际存储的plist文件
• 安卓端对应报错处理：如果安卓真机运行也出现flutter_facebook_auth相关报错，且项目不需要Facebook登录能力，可直接在android/app/build.gradle中添加依赖排除规则，剔除Facebook相关的传递依赖，避免无用依赖被打包进安卓安装包触发报错。

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