从Windows迁移到Mac后Flutter项目pod install遇SSL连接错误

以下是针对Firebase相关podspec下载失败、SSL连接错误的可行解决方案：

• 替换CocoaPods源为国内镜像
  先移除默认的trunk源：

  pod repo remove trunk
  

  添加清华镜像源：

  pod repo add trunk https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git
  

  或者直接在项目的Podfile开头添加指定源（优先级更高）：

  source 'https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git'
  

• 排查网络代理与SSL配置

  • 关闭全局代理工具，避免代理干扰SSL连接；若需使用代理，确保代理规则正确放行CocoaPods相关域名
  • 重置系统登录钥匙串的SSL缓存：

    sudo security flush-keychain -d login
    

  • 检查并更新openssl版本（旧版本可能导致SSL握手失败）：

    # 查看当前版本
    openssl version
    # 用Homebrew更新
    brew install openssl
    

• 强制使用Git源而非CDN
  编辑~/.cocoapods/config.yaml文件，添加以下配置，让CocoaPods通过Git仓库同步所有specs，而非单个下载podspec文件：

  use_source: true
  

• 手动锁定Firebase依赖版本
  如果特定版本的Firebase podspec无法下载，可在Podfile中明确指定稳定版本，避免自动拉取最新版本的spec：

  pod 'Firebase/Core', '~> 10.0.0'
  pod 'Firebase/Analytics', '~> 10.0.0'
  # 其他Firebase组件同理
  

  之后执行pod install即可。

• 彻底清理并重建CocoaPods环境
  在项目目录下执行以下命令：

  rm Podfile.lock
  rm -rf Pods
  pod deintegrate
  pod install
  

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