iOS项目使用多个本地SPM依赖测试时出现"Undefined symbol"错误如何解决

问题根因 #

该报错由SPM静态链接的符号继承规则、不同Target的编译配置不匹配两个核心问题共同导致：

• 仅在主App的「Frameworks, Libraries, and Embedded Content」中链接本地SPM包目标时，这些本地包依赖的外部SPM库只会被链接到主App二进制中，默认不会将符号暴露给单元测试Target，单元测试构建时不会主动检索这些外部依赖的符号
• ___llvm_profile_runtime是代码覆盖率插桩生成的专属符号，仅关闭测试Scheme的代码覆盖率开关不生效的核心原因是主App、本地SPM包、单元测试三者的代码覆盖率编译配置不一致：部分目标开启了插桩生成了依赖该符号的代码，其他目标没有开启插桩就会找不到对应符号

解决方案 #

你可以按优先级尝试以下操作：

• 统一所有Target的代码覆盖率配置：在Xcode Build Settings中搜索CLANG_ENABLE_CODE_COVERAGE，确保主App、所有本地SPM包目标、单元测试Target的该项取值完全一致，统一设置为NO可快速排除插桩符号缺失问题
• 调整单元测试依赖配置：将单元测试Target的「Host Application」设置为当前主App，同时勾选「Allow testing Host Application APIs」，让单元测试直接继承主App已经链接的所有符号
• 手动补充单元测试的链接依赖：在单元测试Target的「Build Phases」→「Link Binary With Libraries」中，手动添加所有报错的外部SPM依赖，不需要设置嵌入规则，仅关联单元测试Target即可
• 修改本地SPM包配置强制导出符号：在本地SPM包的Package.swift中，给对外暴露的目标添加链接器配置强制导出符号，示例如下：

.target(
    name: "你的本地包目标名称",
    dependencies: [
        // 原有外部依赖声明保持不变
        .product(name: "外部依赖产品名", package: "外部依赖仓库名")
    ],
    linkerSettings: [
        .unsafeFlags(["-Xlinker", "-export_dynamic"])
    ]
)

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