Xcode Cloud单元测试持续报“No such module”错误求助

问题概述 #

本地运行单元测试完全正常，但在Xcode Cloud中针对特定标签添加测试动作后执行失败，构建和归档动作可正常运行。测试代码中包含@testable import MY_PROJECT_NAME，切换为“Use Scheme Settings”（已添加单元测试计划）后仍出现相同错误。

排查与解决方案 #

• 确认测试目标的依赖配置
  打开项目的Build Phases，确保单元测试目标的Target Dependencies中已添加主项目目标（MY_PROJECT_NAME），同时Link Binary With Libraries里也包含主项目产物。Xcode Cloud有时会忽略本地隐式依赖，必须显式配置。
• 验证Scheme的测试计划配置
  本地打开Scheme编辑界面，检查Test标签下是否勾选了SplashScreenViewModelUnitTest所在的测试目标，确保Xcode Cloud使用的Scheme和本地配置完全一致，避免云端遗漏测试目标。
• 强制清理Xcode Cloud缓存
  在Xcode Cloud工作流的测试动作前添加xcodebuild clean命令，或者在工作流设置中开启“Clean”动作，清除云端留存的旧构建缓存，避免依赖引用异常。
• 检查主项目的测试可访问性设置
  主项目的Build Settings中，确保对应测试使用的Build Configuration（如Debug）下，ENABLE_TESTABILITY选项设为YES，否则@testable import无法正常访问主项目内部代码。
• 核对测试目标的搜索路径
  在单元测试目标的Build Settings里，检查Header Search Paths和Framework Search Paths，确保包含主项目的头文件与框架路径，避免云端环境下找不到导入模块。

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