Xcode 16.4 + iOS 18 系统运行时崩溃:___cxa_current_primary_exception 符号丢失的原因与解决方案

在使用 Xcode 16.4 构建项目,运行到 iOS 18.3 或更早版本系统 (包括模拟器)时,出现了如下的运行时崩溃

Swift 复制代码
dyld[22183]: Symbol not found: ___cxa_current_primary_exception
  Referenced from: /.../WidgetOn.app/WidgetOn.debug.dylib
  Expected in:     /usr/lib/libc++.1.dylib

本文将讨论一下这个运行时报错的解决方案。

问题背景

这是一个典型的 运行时动态链接失败(dyld) 错误,表面上是找不到 ___cxa_current_primary_exception 符号,实质上是 Swift 6.1 / Xcode 16.4 使用的 C++ ABI 运行时与老版本 iOS 不兼容。

崩溃根因解析

在 iOS 18.4 及更高版本中,Apple 对 libc++ 动态库的内部结构做了修改:

  • 一些 C++ 异常处理相关符号(如 ___cxa_current_primary_exception)原本只存在于 libc++abi.dylib 中;

  • 在新系统中,这些符号被"重定向(indirect)"到 libc++.dylib,并不再直接暴露在 libc++abi.dylib;

  • 编译器在链接时会以为这些符号来自 libc++.dylib;

  • 但当 App 在旧版系统上运行时,libc++.dylib 并没有这些符号;

  • 于是 dyld 报错:符号找不到,程序崩溃

一句话就是Apple 在 iOS 18.4+ 系统中变更了 C++ ABI 符号分布,导致旧系统运行时找不到某些关键符号。

解决方案:强制链接顺序以确保兼容

为了解决这一兼容性问题,我们需要:

让链接器优先从 libc++abi.dylib中加载符号,而不是 libc++.dylib

方法:在项目的**Other Linker Flags(OTHER_LDFLAGS)**中添加:

Swift 复制代码
-Wl,-force_load,$(SDKROOT)/usr/lib/libc++abi.tbd
-Wl,-weak_library,$(SDKROOT)/usr/lib/libc++.tbd
-Wl,-weak_library,$(SDKROOT)/usr/lib/libc++.1.tbd

参数说明:

参数 说明
-Wl 将参数传递给底层链接器 ld
-force_load 强制包含指定库中的全部符号
-weak_library 链接为可选库,在旧系统不存在时不会报错
$(SDKROOT) 当前 Xcode 使用的 SDK 路径

出现问题的常见来源

可能会在以下场景中遇到该问题:

  • 使用 C++ 混编或 Objective-C++;

  • 引入某些广告 SDK、调试 SDK、动态注入工具(如 InjectionIII);

  • 系统调试工具在构建时注入 .debug.dylib;

  • .xcframework 或 binary-only pod 中静态链接了 libc++。

建议配置方式:使用 .xcconfig

推荐在工程中新建一个配置文件 CompatibilityFlags.xcconfig,写入:

Swift 复制代码
// 在 iOS 18.4 及以上版本 中,很多原本只存在于 libc++abi.dylib 中的符号(例如 ___cxa_current_primary_exception),现在被间接定义到了 libc++.dylib 中;
// 但在 iOS 18.3 及以下版本 中,这些符号在 libc++.dylib 中根本就不存在,是"未定义"的。所以当你编译时链接的是 libc++.dylib 中的符号;运行时在老系统中找不到对应实现;
// 导致 dyld(动态链接器)报错,应用在启动时崩溃。
// 解决办法是 强制链接顺序:让 libc++abi.dylib 的链接优先于 libc++.dylib。编译器会把符号绑定到 libc++abi.dylib 而不是 libc++.dylib
OTHER_LDFLAGS = $(inherited) \
  -Wl,-force_load,$(SDKROOT)/usr/lib/libc++abi.tbd \
  -Wl,-weak_library,$(SDKROOT)/usr/lib/libc++.tbd \
  -Wl,-weak_library,$(SDKROOT)/usr/lib/libc++.1.tbd

然后在 Xcode 中为 Debug 或所有构建配置导入使用它。

总结

以上也只是一个临时解决方案,还是希望苹果能从底层解决这个问题,毕竟现在还有很多大项目向前兼容的很多,甚至还有些是 Swift OC 混编的项目。

最后希望上面的解决方案能帮助到遇到这个报错的朋友,文中如果有什么不对的地方,还望路过的朋友指正。

如果觉得有帮助,还望点个赞,添加个关注,笔者也会不断地努力,写出更多更好用的文章。

参考文章: After updating to Xcode 16.3, gett... | Apple Developer Forums

相关推荐
折七4 分钟前
expo sdk53+ 集成极光推送消息推送 ios swift
前端·javascript·ios
猪哥帅过吴彦祖5 分钟前
Flutter 系列教程:布局基础 (上) - `Container`, `Row`, `Column`, `Flex`
前端·flutter·ios
90后的晨仔1 小时前
xcode 16 删除 Provisioning Profiles 文件的有效路径
ios
-晨-风-2 小时前
Flutter 运行IOS真机,提示无法打开“****”
flutter·ios
00后程序员张2 小时前
App 上架全流程指南,iOS 应用发布步骤、ipa 文件上传工具、TestFlight 分发与 App Store 审核经验分享
android·ios·小程序·https·uni-app·iphone·webview
2501_916013742 小时前
iOS App 上架流程详解,苹果应用发布步骤、App Store 审核规则、ipa 文件上传与测试分发实战经验
android·ios·小程序·https·uni-app·iphone·webview
游戏开发爱好者83 小时前
Nginx HTTPS 深入实战 配置、性能与排查全流程(Nginx https
运维·nginx·ios·小程序·https·uni-app·iphone
zzywxc7874 小时前
AI 行业应用:AI 在金融、医疗、教育、制造业等领域的落地案例
人工智能·spring·金融·prompt·语音识别·xcode
游戏开发爱好者84 小时前
TCP 抓包分析:tcp抓包工具、 iOS/HTTPS 流量解析全流程
网络协议·tcp/ip·ios·小程序·https·uni-app·iphone
天堂罗恋歌5 小时前
CocoaPods 安装 Masonry 库时出现的网络连接问题处理
ios·iphone·xcode·cocoapods·app store