Xcode项目Jenkins构建报“No Such Module”问题求助

这种情况我之前在CI构建时也碰到过不少次——本地Xcode跑起来顺顺当当，一到Jenkins就掉链子，核心原因基本都是CI环境下的依赖构建或路径配置和本地不一致，给你几个具体的排查和解决方向：

1. 确保Jenkins构建前执行了Carthage依赖构建命令 #

本地开发时，你可能已经手动执行过carthage bootstrap或者Xcode自动触发了依赖构建，但Jenkins的工作区每次都是全新的（默认情况），必须显式添加构建步骤来拉取并构建依赖：

• 在Jenkins的构建流程里，先添加一个「Execute shell」步骤，切换到项目根目录后执行对应的Carthage命令：

  cd ${WORKSPACE}
  carthage bootstrap --platform iOS --cache-builds
  

  注意替换--platform iOS为你实际的项目平台（比如macOS、tvOS），--cache-builds可以加快后续构建速度。
• 检查命令执行是否成功：如果Jenkins日志里没有Carthage的构建输出，或者出现依赖拉取失败的报错，那就是这一步没做好。

2. 验证Xcode构建的框架搜索路径配置 #

有时候Jenkins环境下Xcode找不到Carthage生成的框架，需要明确指定搜索路径：

• 在Jenkins的Xcode构建步骤中，找到「Build Settings Overrides」，添加FRAMEWORK_SEARCH_PATHS参数，值设置为：

  $(SRCROOT)/Carthage/Build/iOS
  

  同样根据你的平台调整路径（比如Carthage/Build/macOS）。
• 确认项目的Build Phases里已经添加了Copy Frameworks脚本：
  脚本内容为：

  /usr/local/bin/carthage copy-frameworks
  

  并且在「Input Files」里逐个添加所有依赖框架的路径，比如：

  $(SRCROOT)/Carthage/Build/iOS/Alamofire.framework
  $(SRCROOT)/Carthage/Build/iOS/Realm.framework
  

  这个脚本会确保框架被正确复制到最终的App包中，避免运行时找不到模块。

3. 对齐Jenkins和本地的Xcode版本 #

如果本地用的是较新的Xcode版本，而Jenkins服务器上的Xcode版本偏旧，Carthage构建的框架可能存在兼容性问题，导致模块无法识别：

• 在Jenkins构建前添加一个「Execute shell」步骤，切换到和本地一致的Xcode版本：

  sudo xcode-select -s /Applications/Xcode_15.0.app
  

  替换路径为你服务器上对应版本的Xcode安装路径。

4. 清理Jenkins工作区后重新构建 #

Jenkins工作区的旧缓存文件可能干扰依赖构建，尝试清理后重新执行：

• 添加「Execute shell」步骤，清理缓存：

  rm -rf ${WORKSPACE}/Carthage
  rm -rf ~/Library/Developer/Xcode/DerivedData
  

  然后再重新执行Carthage构建和Xcode构建。

如果以上步骤都试过还是不行，可以把Jenkins控制台里的完整错误日志贴出来，特别是Carthage构建阶段的输出，能更精准定位问题。

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