Widget Extension单元测试报Undefined Symbol: nominal type descriptor错误求解

这个错误属于链接阶段符号缺失，和编译阶段的模块导入无关：@testable import只是给编译器暴露了模块的类型声明，让编译阶段可以正常识别MyStruct类型，但链接阶段需要从MyAppWidgetExtension的二进制产物中读取MyStruct的实际符号实现，找不到就会抛出该错误。

常见触发原因 #

• MyStruct的符号被死代码剥离移除：Swift默认结构体访问级别为internal，如果你的MyAppWidgetExtension自身业务代码没有任何地方引用MyStruct，且构建设置中DEAD_CODE_STRIPPING（死代码剥离）处于开启状态，编译器会判定该类型未被使用，直接从Widget Extension的二进制中移除该类型的所有符号，导致单元测试链接时找不到对应实现。
• 单元测试目标未正确链接Widget Extension产物：检查单元测试目标的Build Phases > Link Binary With Libraries列表，确认已经添加了MyAppWidgetExtension.appex产物。
• 类型归属配置错误：检查定义MyStruct的源文件的Target Membership配置，确认已经勾选MyAppWidgetExtension，而非仅勾选了单元测试目标。

验证与修复方案 #

快速验证方案：在Widget Extension的任意可执行代码段中添加一行对MyStruct的引用，比如在Widget的body实现中加入let _ = MyStruct()，重新执行单元测试，如果错误消失即可判定为死代码剥离导致的问题。

对应修复方案可选：

• 给MyStruct添加public访问修饰符，避免被判定为无用内部代码
• 在MyAppWidgetExtension的构建设置中，针对Debug/测试构建场景关闭DEAD_CODE_STRIPPING
• 给MyAppWidgetExtension的测试构建设置添加OTHER_SWIFT_FLAGS = -Xfrontend -enable-testing参数，开启测试模式下的符号保留

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