升级Flutter后执行pod install遇FirebaseAppCheck版本兼容错误求助

问题背景 #

升级Flutter版本后执行pod install时触发CocoaPods版本冲突错误，具体错误信息如下：

CocoaPods could not find compatible versions for pod "FirebaseAppCheck":
  In snapshot (Podfile.lock):
    FirebaseAppCheck (= 10.3.0, ~> 10.3.0-beta)

  In Podfile:
    firebase_app_check (from `.symlinks/plugins/firebase_app_check/ios`) was resolved to 0.1.2-2, which depends on
      FirebaseAppCheck (~> 10.7.0-beta)


You have either:
 * out-of-date source repos which you can update with `pod repo update` or with `pod install --repo-update`.
 * changed the constraints of dependency `FirebaseAppCheck` inside your development pod `firebase_app_check`.
   You should run `pod update FirebaseAppCheck` to apply changes you've made.

已尝试pod deintegrate、repo update、删除Podfile.lock、升级iOS平台版本、flutter clean等常规操作，虽能消除pod install错误，但Xcode归档构建时会出现新问题，核心矛盾为FirebaseAppCheck的版本兼容性不匹配。

针对性解决方案 #

方案1：统一Firebase SDK版本适配插件依赖 #

1. 在iOS目录的Podfile顶部添加全局版本控制，指定与插件依赖匹配的Firebase SDK版本：

$FirebaseSDKVersion = '10.7.0-beta'

2. 执行以下命令彻底重置依赖链：

flutter clean
cd ios
pod deintegrate
rm Podfile.lock
pod install --repo-update

3. 验证依赖状态：执行pod outdated确认所有Firebase相关pod均已同步到指定版本。

方案2：降级Flutter插件到兼容版本 #

若无需升级Firebase SDK，可将firebase_app_check插件降级至依赖10.3.0-beta版本的旧版本：

1. 修改项目根目录pubspec.yaml中的插件版本：

firebase_app_check: ^0.1.1+1 # 该版本依赖FirebaseAppCheck ~>10.3.0-beta

2. 更新依赖并重新安装pod：

flutter pub get
cd ios
pod install --repo-update

方案3：修复Xcode归档构建异常 #

若执行pod update后pod install正常但归档失败，可尝试以下操作：

• 打开Xcode，执行Product > Clean Build Folder清理构建缓存
• 检查项目Build Settings中的Valid Architectures是否包含目标归档架构（如arm64）
• 确保Podfile中platform :ios指定的版本与Xcode项目的Deployment Target完全一致

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