Cocoapods安装gRPC-Core失败求助：Firebase集成遇网络错误

问题背景 #

使用Xcode 13.4.1尝试通过Swift Package Manager安装Firebase两次失败，且因SPM启动Xcode时会随机下载消耗流量，转而使用CocoaPods。Podfile配置如下：

platform :ios, '13.0'

target 'App' do
  use_frameworks!

  pod 'FirebaseAuth'
  pod 'FirebaseFirestore'
end

安装过程中，下载近1GB的gRPC-Core (1.49.1)后失败，控制台报错显示子模块克隆时网络断开、early EOF等问题。相关环境：

• Swift版本：swift-driver version: 1.45.2，Apple Swift version 5.6.1
• Pod版本：1.15.0
• Command Line tools版本：13.2.0.0.1.1637719136

解决方案 #

1. 清理CocoaPods缓存与本地Pod文件 #

执行以下命令清空缓存并删除本地已生成的Pod相关文件，避免损坏缓存导致的重复失败：

pod cache clean --all
rm -rf Pods/ Podfile.lock

2. 替换gRPC-Core的仓库源为国内镜像 #

在Podfile开头添加镜像配置，替换官方gRPC仓库为国内镜像，提升下载稳定性：

source 'https://cdn.cocoapods.org/'
# 替换gRPC相关库的源为国内镜像
pod 'gRPC-Core', :git => 'https://gitee.com/mirrors/grpc.git', :tag => 'v1.49.1', :submodules => true
pod 'gRPC-C++', :git => 'https://gitee.com/mirrors/grpc.git', :tag => 'v1.49.1', :submodules => true

platform :ios, '13.0'

target 'App' do
  use_frameworks!

  pod 'FirebaseAuth'
  pod 'FirebaseFirestore'
end

修改后执行pod install，镜像源的下载速度更快，能有效降低网络断开概率。

3. 手动克隆gRPC仓库并指定本地路径 #

如果网络环境极差，可手动克隆gRPC仓库到本地，让Pod直接使用本地文件：

1. 手动克隆指定版本的gRPC仓库（带子模块）：

git clone --recursive https://gitee.com/mirrors/grpc.git -b v1.49.1

2. 在Podfile中指定本地路径：

platform :ios, '13.0'

target 'App' do
  use_frameworks!

  pod 'FirebaseAuth'
  pod 'FirebaseFirestore'
  # 指定本地gRPC路径
  pod 'gRPC-Core', :path => '/你的本地路径/grpc/src/core'
  pod 'gRPC-C++', :path => '/你的本地路径/grpc/src/cpp'
end

之后执行pod install即可跳过下载步骤。

4. 延长CocoaPods下载超时时间 #

大文件下载时容易因默认超时时间过短导致断开，执行pod install时添加超时参数：

pod install --verbose --timeout=1200

将超时时间设置为20分钟，给大文件足够的下载时间。

5. 匹配Command Line Tools与Xcode版本 #

当前使用Xcode 13.4.1，建议将Command Line Tools升级到对应版本：

• 打开Xcode → 偏好设置 → Locations
• 在Command Line Tools下拉菜单中选择Xcode 13.4.1对应的版本，避免版本不兼容引发的隐性问题

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