You need to enable JavaScript to run this app. 升级Firebase库后提示FirebaseInstallations与Instance ID版本不兼容如何解决?
优惠活动
大模型
产品
解决方案
定价
更多

升级Firebase库后提示FirebaseInstallations与Instance ID版本不兼容如何解决?

报错原因

即使FirebaseInstanceID已被废弃,部分旧版本Firebase组件(如旧版云消息传递、统计分析组件)仍会间接依赖该库,你仅新增Firebase/Installations依赖但未清理旧的Pod缓存与版本锁文件,就会触发新旧组件不兼容的报错。

解决方案

  • 第一步:清理业务代码中所有InstanceID()相关的旧API调用,全部替换为Firebase/Installations对应的等效API,示例如下:
Installations.installations().installationID { installationID, error in
    if let error = error {
        // 自定义错误处理逻辑
        return
    }
    // 正常使用获取到的installationID
}
  • 第二步:调整Podfile配置,删除所有显式引入的FirebaseInstanceID相关pod声明,确认已添加pod 'Firebase/Installations',同时将所有其他Firebase相关pod都升级到最新稳定版本,避免组件间版本不匹配。
  • 第三步:执行如下命令清理旧Pod缓存并重新拉取依赖:
// 移除现有Pod集成
pod deintegrate
// 清理全局CocoaPods缓存
rm -rf ~/Library/Caches/CocoaPods
// 删除本地依赖锁文件
rm Podfile.lock
// 同步远程仓库后重新拉取最新版本依赖
pod install --repo-update
  • 第四步:打开Xcode项目后,依次按下Command+Shift+K清空编译缓存、Option+Command+Shift+K清空所有构建产物,重新编译项目即可解决报错。

内容的提问来源于stack exchange,提问作者Lance Samaria

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.15 10:54:01