Expo iOS构建因Pod安装失败求助（Windows环境）

核心排查方向及解决步骤 #

• 确认Expo服务状态
  先查Expo官方状态页面，确认构建服务器、CocoaPods相关服务是否正常，偶尔Expo的依赖源会出现临时访问波动。
• 更新工具链版本
  旧版本EAS CLI或Expo SDK可能存在依赖解析bug，执行命令更新：

  npm install -g eas-cli
  expo upgrade
  

  注意：升级SDK前先备份项目，避免兼容性冲突。
• 锁定依赖版本
  对比上次成功构建的依赖版本，确保package-lock.json或yarn.lock未被改动；若有新增依赖，尝试锁定其版本，避免自动拉取最新不稳定版本。
• 清理构建缓存
  缓存可能残留异常数据，执行命令清空EAS构建缓存：

  eas build:cache:clear
  

• 替换CocoaPods源
  Pod安装超时多因官方源访问慢，可自定义Pod源加速：
  1. 项目根目录创建ios/Podfile（Windows用户可通过WSL执行expo prebuild --platform ios生成基础文件）
  2. 在Podfile开头添加镜像源：

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

  3. 在eas.json中配置使用该Podfile：

     {
       "build": {
         "production": {
           "ios": {
             "podfile": "./ios/Podfile"
           }
         }
       }
     }
     

• 排查新增依赖
  检查上次成功后新增的npm包，部分第三方包的iOS依赖可能存在兼容性问题，可临时移除最近新增的包，逐步排查出问题依赖。

无额度消耗的本地测试方法 #

Windows用户可安装WSL并配置iOS构建环境，执行eas build --platform ios --local在本地测试构建，提前验证问题，避免消耗Expo免费额度。

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