自分のアプリ LadyFly のバージョン 2.0 で出た dyld: Symbol not found は、こんな現れ方をしました。iOS 16 と 17 の iPhone で、最初の画面が出る前にアプリが終了します。iOS 18 以降は問題なし。気づいたのはリリースの2日後、App Store Connect のクラッシュ数でした。以下、順を追って書きます。レポートの場所、足りないシンボルを引き込んでいるライブラリの探し方、そして Podfile の1か所の変更で直った経緯です。
環境: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 の概要に「バージョン別クラッシュ」のカードがあります。バージョン 2.0 は 8 件、前のバージョン 1.13 は 90 日間で 1 件でした。Metrics でクラッシュを OS バージョン別に分けると、8 件はすべて iOS 17.6 で、リリースから2日以内に集中していました。この数字は診断情報の共有に同意したユーザーの分だけなので、実際はもっと多いはずです。
Web のダッシュボードにスタックトレースはなく、件数だけです。
Xcode Organizer。 完全なレポートは Xcode にあります。Window → Organizer → Crashes で左のアプリを選び、バージョン 2.0 を開きます。Xcode は3台のデバイスから5件のレポートをダウンロードし、NO_CRASH_STACK としてまとめました。ダウンロード後のファイルはディスク上にあり、ターミナルから読むほうが楽です。
~/Library/Developer/Xcode/Products/<bundle id>/Crashes/Points/*/Filters/*/Logs/*.crashレポートの中身:libc++ の dyld Symbol not found#
5件とも同じ内容で、iOS 16.7.16 の iPhone 8 でした。
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 の前にプロセスを終了させた、という意味です。スタックがないのもそのためで、アプリのコードはまだ1行も動いていません。
c++filt に通すと、シンボルは std::exception_ptr::__from_native_exception_pointer(void*) と読めます。iOS の C++ 標準ライブラリ libc++ にある関数です。
最初の推測は外れた#
バージョン 2.0 では、古い iOS にはないフレームワークを追加していました。写真の提案に使う FoundationModels(iOS 26 以降)、Translation、ActivityKit です。まずこれらを疑い、アーカイブを調べました。
otool -l LadyFly.app/LadyFly | grep -A2 LC_LOAD_WEAK_DYLIB3つとも LC_LOAD_WEAK_DYLIB、つまり任意のリンクで、コードは #available の内側にあります。原因がこれらなら、レポートに出るのは libc++ ではなくフレームワーク名のはずです。
このシンボルが必要とする iOS バージョン#
答えは SDK のヘッダーにありました。usr/include/c++/v1/__configuration/availability.h で、この関数には _LIBCPP_INTRODUCED_IN_LLVM_18 が付いています。Apple のプラットフォームでは 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ヒットはちょうど1件、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 を他に2か所(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 を手で書き換えても意味がありません。次のインストールで消えます。このプロジェクトにはもともと、fmt ライブラリのヘッダーを同じ方法でパッチする post_install フックがあったので、その隣に2つ目のパッチを足しました。
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
endpod install とアーカイブビルドのあと、バイナリを確認しました。
nm -u LadyFly.app/LadyFly | grep -c from_native_exception_pointer2.0 (69) は 1、修正後のビルドは 0 でした。iOS 16 や 17 のシミュレータは手元になかったので、これは静的な確認です。古い OS で実際に動かしたのではなく、バイナリが何を参照しているかを見ています。
もう1つの落とし穴:パスの空白#
修正入りの最初のアーカイブは、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 に上げ、ビルドをアップロードし、8言語すべての「このバージョンの新機能」を埋めて、承認後に自動でリリースされる設定にしました。この記事を書いている時点で、バージョンは審査中です。
Apple には、まさにこの状況のためのフォームがあります。優先審査のリクエストです。使えるのは、バージョンを審査に提出したあとだけです。アプリとプラットフォームを選びます。送信すると、優先審査にすると Apple からすぐ返事がありました。バージョンがリジェクトされた場合、再提出は自動的に同じキューに戻ります。
同じビルドを二度と出さないために#
アップロードの前には毎回、自作のチェックスクリプトでアーカイブを通しています。権限の説明文、プライバシーマニフェスト、拡張機能のバージョンを見るものです。ここに1つ検査を足しました。デプロイメントターゲットが 18 未満のとき、__from_native_exception_pointer、__cxa_init_primary_exception など、新しい libc++ のシンボルをいくつか探します。古い 2.0 (69) のアーカイブでは2つ同時に見つかりました。2つ目には気づいていませんでした。dyld が報告するのは最初に見つからなかったシンボルだけだからです。2.0.1 のアーカイブではエラー0件でした。
Swift と C++ interop を使うコードや、Nitro のような pod があるプロジェクト向けの短い版がこれです。
nm -u Payload/App.app/App | grep -E 'from_native_exception_pointer|cxa_init_primary_exception'出力が空なら、iOS 15〜17 でローダーがこれらのシンボルでつまずくことはありません。リリースビルドをクラウドで行っているなら、この1行は ci_post_xcodebuild.sh に入れられます。このスクリプトについては Xcode Cloud ガイドで詳しく書いています。アップロード後に App Review が何を見るかは、2026年10月の App Review ガイドラインの記事にあります。



