Xcode 15编译App在iOS15崩溃：dyld提示Swift/SwiftUI符号缺失

问题现象 #

App在Xcode 15.1中编译链接正常，最低部署目标设为iOS 15，上传TestFlight后，在iOS15.x模拟器或真机运行时直接崩溃，无堆栈跟踪，控制台和崩溃报告显示dyld报错找不到对应符号：

控制台报错示例 #

dyld[8011]: Symbol not found: _swift_getExtendedExistentialTypeMetadata
  Referenced from: /Users/jonas/Library/Developer/CoreSimulator/Devices/04C9C2EC-A371-4523-9E71-3A5A0A3BBD02/data/Containers/Bundle/Application/799DE0D8-FDC1-4378-BC4C-AE4157CED3B0/SwiftPackageIssue.app/SwiftPackageIssue
  Expected in: /Library/Developer/CoreSimulator/Profiles/Runtimes/iOS 15.5.simruntime/Contents/Resources/RuntimeRoot/usr/lib/swift/libswiftCore.dylib

崩溃报告示例 #

Exception Type:  EXC_CRASH (SIGABRT)
Exception Codes: 0x0000000000000000, 0x0000000000000000
Exception Note:  EXC_CORPSE_NOTIFY
Termination Reason: DYLD 4 Symbol missing
Symbol not found: _$s7SwiftUI28BorderedProminentButtonStyleVAA09PrimitiveeF0AAMc
Referenced from: /private/var/containers/Bundle/Application/53FB853D-69A1-4EDF-A118-A5C56839968D/myApp.app/myApp
Expected in: /System/Library/Frameworks/SwiftUI.framework/SwiftUI

Triggered by Thread:  0


Thread 0 Crashed:
0   dyld                            0x0000000101d04be8 __abort_with_payload + 8
1   dyld                            0x0000000101cde498 abort_with_payload_wrapper_internal + 104 (terminate_with_reason.c:102)
2   dyld                            0x0000000101d0958c abort_with_payload + 16 (terminate_with_reason.c:124)
3   dyld                            0x0000000101cedba4 dyld4::halt(char const*) + 328 (DyldProcessConfig.cpp:2004)
4   dyld                            0x0000000101cc7a00 dyld4::prepare(dyld4::APIs&, dyld3::MachOAnalyzer const*) + 3520 (dyldMain.cpp:0)
5   dyld                            0x0000000101cdb6fc start + 488 (dyldMain.cpp:879)

核心原因 #

Xcode 15.1基于Swift 5.9编译，引入了部分新的Swift运行时符号（如_swift_getExtendedExistentialTypeMetadata），这些符号不存在于iOS15的系统Swift库中；同时部分SwiftUI API在新版本编译链下生成了依赖更高系统版本的符号，即使API本身标注为iOS15可用。

解决步骤 #

1. 启用嵌入Swift标准库 #

在Target的Build Settings中，找到Embed Swift Standard Libraries选项，设置为YES。此操作会将App依赖的Swift标准库打包到安装包中，避免依赖iOS15系统中缺失的符号。

2. 检查Swift Package依赖的部署目标 #

如果项目使用了Swift Package Manager：

• 打开Xcode的Package Dependencies列表，逐个检查每个依赖包的最低部署目标，确保不高于iOS15；
• 若依赖包未正确设置部署目标，可在Package的Package.swift中修改platforms配置，或者在Xcode中右键依赖包选择Show Build Settings，手动调整其iOS部署目标为iOS15。

3. 验证API适配并清理构建缓存 #

• 确认代码中使用的SwiftUI API（如BorderedProminentButtonStyle）确实在iOS15上可用，若存在误用更高版本API的情况，添加@available(iOS 15.0, *)标记或做降级适配；
• 执行Command+Shift+K清理当前构建，删除DerivedData目录（默认路径：~/Library/Developer/Xcode/DerivedData），重新构建并测试。

4. 调整Swift编译选项 #

在Target的Build Settings中：

• 找到Build Libraries for Distribution，设置为NO（仅针对App Target，框架Target需保持YES）；
• 确认Swift Language Version设置为Swift 5.9，避免版本不匹配导致的符号生成问题。

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