You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

M1 Mac中Flutter项目添加Cloud Firestore后CocoaPods报错求助

Flutter添加Cloud Firestore后iOS端Pod安装失败解决方案

从报错核心信息CDN: trunk URL couldn't be downloaded: https://cdn.cocoapods.org/CocoaPods-version.yml Response: URL using bad/illegal format or missing URL来看,问题根源是CocoaPods无法正常访问官方CDN仓库,以下是针对性解决步骤:

解决方案1:切换CocoaPods到国内镜像源

国内访问官方CDN常出现解析或连接问题,换成清华镜像源可快速解决:

# 移除官方trunk源
pod repo remove trunk
# 添加清华镜像源
pod repo add trunk https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git
# 更新仓库
pod repo update

回到iOS目录重新执行安装:

cd ios
pod install

临时测试也可直接指定镜像源执行:

pod install --repo-update --verbose --sources=https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git

解决方案2:升级CocoaPods到最新版本

旧版本CocoaPods存在HTTPS URL处理bug,升级到最新版本修复:

sudo gem update cocoapods

升级完成后重新执行pod install。

解决方案3:清理CocoaPods缓存并重新集成

# 进入iOS目录
cd ios
# 完全移除现有Pods集成
pod deintegrate
# 清理所有Pod缓存
pod cache clean --all
# 重新安装依赖
pod install

解决方案4:调整系统DNS设置

若为DNS解析错误导致URL格式报错,可修改系统DNS为:

  • 谷歌公共DNS:8.8.8.8 / 8.8.4.4
  • 国内公共DNS:114.114.114.114
    修改后重启终端,再执行pod install。

额外检查:Firebase插件版本兼容性

确保pubspec.yaml中所有Firebase相关插件版本统一,示例:

firebase_core: ^2.15.0
cloud_firestore: ^4.8.2
firebase_auth: ^4.9.0

执行flutter pub get后,再进入iOS目录执行pod install。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.11 19:50:44