使用Expo构建App Store应用时遇Pods版本兼容问题求助

1. 定位具体冲突项 #

仔细查看构建日志里的详细错误信息，日志会明确指出哪些Pod依赖了同一库的不同版本（比如库A要求X ~> 1.0，库B要求X ~> 2.0），只有确定冲突根源才能针对性解决。

2. 强制锁定依赖版本 #

根据日志找到冲突的依赖库后，通过包管理器强制统一版本：

• npm（8.3及以上）：在package.json中添加：

  "overrides": {
    "冲突依赖名称": "兼容的目标版本号"
  }
  

• Yarn：在package.json中添加：

  "resolutions": {
    "冲突依赖名称": "兼容的目标版本号"
  }
  

3. 更新Expo及第三方依赖 #

确保Expo SDK处于最新稳定版，运行命令更新：

expo update

同时更新项目里的第三方库，旧库可能依赖过时的Pod版本：

npm update
# 或使用Yarn：yarn upgrade

4. 本地调试Pod依赖 #

在本地环境（需安装Xcode和CocoaPods）生成iOS原生目录，排查冲突：

expo prebuild --platform ios

进入ios目录后执行：

pod install --verbose

本地会输出更详细的冲突细节，解决后再重新提交Expo构建。

5. 清理冗余依赖 #

检查项目中未使用的第三方库，移除后减少冲突可能性：

npm uninstall 未使用的库名
# 或使用Yarn：yarn remove 未使用的库名

6. 重置本地依赖环境 #

彻底清理本地残留的依赖缓存：

rm -rf node_modules
rm package-lock.json # Yarn用户删除yarn.lock
npm install # 或 yarn install

之后执行expo prebuild --clean --platform ios清理原生目录，再尝试构建。

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