我的应用 LadyFly 2.0 版本出现了 dyld: Symbol not found 错误,表现是这样的:在 iOS 16 和 17 的 iPhone 上,应用启动后立刻退出,连第一个界面都没出现。iOS 18 及以上一切正常。我是发布两天后,从 App Store Connect 的崩溃计数里才发现的。下面按步骤写:去哪里找崩溃报告,怎样找出引入缺失符号的库,以及一处 Podfile 改动是怎么修好它的。
环境:Xcode 27.1、iOS 27.1 SDK、React Native 0.81.4、react-native-nitro-modules 0.29.6,最低部署目标 iOS 15.1。
去哪里看启动崩溃#
App Store Connect。 Analytics 概览里有一张“Crashes by app version”卡片。2.0 版本显示 8 次;上一个版本 1.13 在 90 天里只有 1 次。在 Metrics 里按系统版本分组后,8 次全部出现在 iOS 17.6,且都在发布后两天内。这些数字只来自同意分享诊断数据的用户,所以实际数量更多。
网页后台没有堆栈,只有计数。
Xcode Organizer。 完整报告在 Xcode 里:Window → Organizer → Crashes,左侧选应用,再选 2.0 版本。Xcode 从三台设备下载了五份报告,归类为 NO_CRASH_STACK。之后这些文件就存在磁盘上,用终端读起来更方便:
~/Library/Developer/Xcode/Products/<bundle id>/Crashes/Points/*/Filters/*/Logs/*.crash报告里写了什么:libc++ 的 dyld Symbol not found#
五份报告完全一样,设备是 iPhone 8,系统 iOS 16.7.16:
Exception Type: EXC_CRASH (SIGABRT)
Termination Reason: DYLD 4 Symbol missing
Symbol not found: __ZNSt13exception_ptr31__from_native_exception_pointerEPv
Referenced from: .../LadyFly.app/LadyFly
Expected in: /usr/lib/libc++.1.dylib
(terminated at launch; ignore backtrace)Termination Reason: DYLD 4 Symbol missing 的意思是:加载器 dyld 在系统库里找不到二进制引用的某个函数,于是在 main 之前就杀掉了进程。所以也没有堆栈:应用自己的代码一行都还没执行。
用 c++filt 还原后,这个符号是 std::exception_ptr::__from_native_exception_pointer(void*)。它是 libc++ 里的函数,而 libc++ 是 iOS 上的 C++ 标准库。
我的第一个猜测是错的#
2.0 版本新增了旧版 iOS 没有的框架:用于照片建议的 FoundationModels(iOS 26+)、Translation 和 ActivityKit。我最先怀疑它们,并检查了归档:
otool -l LadyFly.app/LadyFly | grep -A2 LC_LOAD_WEAK_DYLIB三个都以 LC_LOAD_WEAK_DYLIB 链接,即可选链接,相关代码都在 #available 之后。如果问题出在它们身上,报告里写的会是框架名,而不是 libc++。
这个符号需要哪个 iOS 版本#
答案在 SDK 头文件里。usr/include/c++/v1/__configuration/availability.h 中,这个函数被标记为 _LIBCPP_INTRODUCED_IN_LLVM_18,而在苹果平台上 LLVM 18 对应 iOS 18。iOS 16 和 17 自带的 libc++ 更旧,没有它。
通常这没有问题。部署目标低于 18 时,clang 看到这个标记,会把 std::make_exception_ptr 编译成旧的 throw/catch 路径,不用这个新函数。所以说明有一段代码绕过了这个检查。
怎样找出引入这个符号的库#
应用二进制由几十个 CocoaPods 静态库链接而成。归档构建之后,中间产物 .a 文件还留在 DerivedData 里,nm -u 能显示哪个目标文件引用了这个符号:
D=~/Library/Developer/Xcode/DerivedData/LadyFly-*/Build/Intermediates.noindex/ArchiveIntermediates
find $D -name '*.a' -path '*iphoneos*' | while read f; do
nm -u -A "$f" 2>/dev/null | grep from_native_exception_pointer
done只命中一处:libNitroModules.a:RuntimeError.o。Nitro Modules 是 LadyFly 里 react-native-unistyles 所依赖的原生层。
Nitro 的 ios/utils/RuntimeError.hpp 里有一个小函数:
static inline std::exception_ptr makeException(const std::string& message) {
return std::make_exception_ptr(std::runtime_error(message));
}Nitro 的 Swift 代码(RuntimeError.swift)通过 C++ interop 调用它。我的解释是:这个内联函数在 Swift 一侧编译时,会跳过 libc++ 的可用性检查,直接链接新函数。支持这个解释的事实是:Nitro 在另外两处也调用了 make_exception_ptr(Promise.hpp、JSIConverter+Exception.hpp),但它们由普通 clang 编译,没有引入这个符号。所有 pod 都是按 iOS 15.1 构建的,所以问题不在部署目标。
在 Podfile 里修复#
makeException 必须在不用新函数的情况下构造出 exception_ptr。有一种在任何版本的 libc++ 上都能用的写法:抛出异常再捕获。
try {
throw std::runtime_error(message);
} catch (...) {
return std::current_exception();
}手动改 node_modules 没有意义,下次安装改动就没了。项目里本来就有一个 post_install 钩子,用同样的方式给 fmt 库的一个头文件打补丁,所以我在它旁边加了第二个补丁:
nitro_error = File.join(__dir__, '..', 'node_modules', 'react-native-nitro-modules', 'ios', 'utils', 'RuntimeError.hpp')
if File.exist?(nitro_error)
source = File.read(nitro_error)
patched = source.sub(
'return std::make_exception_ptr(std::runtime_error(message));',
"try {\n throw std::runtime_error(message);\n } catch (...) {\n return std::current_exception();\n }"
)
File.write(nitro_error, patched) if patched != source
end执行 pod install 并重新归档后,我检查了二进制:
nm -u LadyFly.app/LadyFly | grep -c from_native_exception_pointer2.0 (69) 的结果是 1,修复后的构建是 0。我手头没有 iOS 16 或 17 的模拟器,所以这只是静态检查:我看的是二进制引用了什么,并没有在旧系统上运行它。
还有一个坑:路径里的空格#
带修复的第一次归档,在打包 JS 时失败了:
/bin/sh: /Users/dodecaidr/Desktop/My: No such file or directoryReact Native 模板的构建脚本调用 /bin/sh -c "$WITH_ENVIRONMENT $REACT_NATIVE_XCODE" 时没有给路径加引号,而我的项目放在名为 “My Progect” 的文件夹里。我把项目复制到一个没有空格的文件夹,在副本里构建归档,并把 REACT_NATIVE_PATH 指向这个副本。
加急审核发布 2.0.1#
剩下的都是例行公事:在应用和小组件的 Info.plist 里把版本号改成 2.0.1、构建号改成 70,上传构建,在八种本地化里填写“What's New”,并设置为审核通过后自动发布。写下这些时,该版本正在审核中。
Apple 为这种情况准备了专门的表单:申请加急审核。它只有在版本提交之后才能用。选择应用和平台;我提交后,Apple 立刻确认会加急审核。如果版本被拒,重新提交会自动回到同一个队列。
怎样避免再次发布这样的构建#
每次上传之前,我都会用自己的检查脚本过一遍归档:权限文案、隐私清单、扩展版本。现在它又多了一项检查:部署目标低于 18 时,查找 __from_native_exception_pointer、__cxa_init_primary_exception 以及较新 libc++ 中的另外几个符号。对旧的 2.0 (69) 归档,它一次就找出了两个;第二个我之前没发现,因为 dyld 只报告第一个缺失的符号。对 2.0.1 归档,错误数为零。
如果你的项目里有使用 C++ interop 的 Swift 代码,或者像 Nitro 这样的 pod,可以直接用这行简短的命令:
nm -u Payload/App.app/App | grep -E 'from_native_exception_pointer|cxa_init_primary_exception'输出为空,就说明加载器在 iOS 15–17 上不会被这些符号绊倒。如果你在云端构建发布版本,这一行可以放进 ci_post_xcodebuild.sh;这类脚本在我的 Xcode Cloud 指南 里有更详细的介绍。上传之后 App Review 会看什么,见 2026 年 10 月 App Review 指南的文章。



