iOS构建报错：无法解析同版本的两个CocoaPods依赖

问题原因 #

你遇到的这个错误，本质是CocoaPods依赖解析时的缓存/索引异常，或是项目中存在隐式的重复依赖声明：

• 虽然PromisesObjC的版本要求完全一致，但CocoaPods的spec索引缓存过期，或是CI环境的spec源未同步最新索引，导致它无法识别该版本的spec存在；
• 项目中可能有其他第三方库直接或间接依赖了PromisesObjC，和PromisesSwift的依赖形成了重复声明，在缓存异常的情况下触发了解析错误。

解决步骤 #

1. 彻底清理缓存
   本地和CI环境都执行以下命令，清除所有Pod缓存：

   pod cache clean --all
   

2. 检查并统一依赖声明

   • 搜索项目的Podfile和所有第三方依赖，确认是否有其他地方直接声明了pod 'PromisesObjC'，如果有，删除该声明（PromisesSwift已经自带对它的依赖）；
   • 检查项目中引入的静态库/SDK，是否有内置PromisesObjC的情况，若存在需排查冲突。

3. 更新Spec索引
   强制更新本地和CI的Spec仓库索引，确保获取最新的Pod版本信息：

   pod repo update
   

4. 重新生成依赖文件
   删除旧的依赖文件后，强制基于最新索引重新安装：

   rm -rf Podfile.lock Pods *.xcworkspace
   pod install --repo-update
   

5. 统一CocoaPods版本
   确保本地开发环境和CI环境使用相同版本的CocoaPods，版本不一致可能导致解析逻辑差异：

   # CI环境指定安装特定版本，例如1.15.0
   sudo gem install cocoapods -v 1.15.0
   

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