Github Action中Swift iOS项目CocoaPods构建失败：找不到Pods_iosapp框架

从你给出的错误日志和配置来看，这个问题大概率和CocoaPods框架链接方式、GitHub Actions环境下的模拟器架构或者xcodebuild命令参数有关。以下是几个针对性的解决方案，按优先级尝试：

1. 替换固定模拟器ID为通用模拟器名称 #

你在matrix里用了具体的模拟器ID，但GitHub Actions的macOS环境里的模拟器ID可能和你本地不一致，不同版本的Xcode自带的模拟器ID也会频繁变化。建议换成更通用的模拟器名称，比如：

matrix:
  destination: ['platform=iOS Simulator,name=iPhone 14,OS=latest', 'platform=iOS Simulator,name=iPhone SE (3rd generation),OS=latest']

这样GitHub Actions会自动找到对应版本的可用模拟器，避免因ID不匹配导致的架构或路径异常。

2. 调整CocoaPods的框架链接方式 #

你的Podfile里用了use_frameworks!，默认是动态框架，在CI环境下容易出现链接路径问题。可以尝试改为静态框架链接，修改Podfile：

use_frameworks! :linkage => :static

修改后提交到仓库，CI执行pod install时会生成静态框架，能避免动态框架在多架构编译时的查找冲突，同时也能解决MergeSwiftModule的报错。

3. 优化xcodebuild命令参数 #

你的xcodebuild命令可以补充几个关键参数，确保正确引用Pods的配置：

xcodebuild clean test \
  -workspace iosapp.xcworkspace \
  -scheme iosapp \
  -destination "${destination}" \
  -configuration Debug \
  CODE_SIGN_IDENTITY="" \
  CODE_SIGNING_REQUIRED=NO \
  ONLY_ACTIVE_ARCH=YES \
  BUILD_LIBRARY_FOR_DISTRIBUTION=YES

• 显式指定-configuration Debug，避免环境默认配置不一致；
• 把ONLY_ACTIVE_ARCH改为YES，只编译当前模拟器的活跃架构，减少多架构编译的冲突；
• 添加BUILD_LIBRARY_FOR_DISTRIBUTION=YES，确保Swift模块编译符合分发标准，解决MergeSwiftModule失败的问题。

4. 确保CocoaPods版本一致性 #

本地和CI环境的CocoaPods版本差异也可能导致依赖构建异常。可以在GitHub Actions的step里指定和本地一致的版本：

- name: Install matching CocoaPods version
  run: sudo gem install cocoapods -v 1.12.1 # 替换成你本地的CocoaPods版本

先执行这个step，再运行pod install，消除版本差异带来的问题。

5. 验证Pod依赖的安装状态 #

在pod install之后，可以添加一个step检查Pods目录是否正常生成，以及框架文件是否存在：

- name: Verify Pods setup
  run: |
    ls -la Pods/
    ls -la iosapp.xcworkspace/

如果Pods目录为空，说明pod install执行失败，可以在pod install命令后添加--verbose参数查看详细日志，排查网络或依赖源的问题。

试完这些方案后，应该能解决你遇到的"Framework not found Pods_iosapp"和MergeSwiftModule失败的问题。

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