Ошибка dyld: Symbol not found в версии 2.0 моего приложения LadyFly выглядела так: на iPhone с iOS 16 и 17 приложение закрывалось сразу после запуска, ещё до первого экрана. На iOS 18 и новее всё работало. Я узнал об этом через два дня после релиза, из счётчика сбоев в App Store Connect. Ниже по шагам: где смотреть отчёты, как найти библиотеку, которая тянет отсутствующий символ, и как я закрыл это одной правкой в Podfile.
Окружение: Xcode 27.1, SDK iOS 27.1, React Native 0.81.4, react-native-nitro-modules 0.29.6, минимальная версия приложения iOS 15.1.
Где увидеть сбои при запуске#
App Store Connect. В разделе «Аналитика» на обзоре есть карточка «Сбои по версии приложения». У 2.0 там стояло 8, у предыдущей 1.13 за 90 дней один. Если открыть «Показатели» и сгруппировать сбои по версии платформы, все восемь оказались на 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Что было в отчёте: dyld Symbol not found в libc++#
Все пять отчётов одинаковые, 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++, стандартной библиотеки C++ в iOS.
Первая версия была неверной#
В 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 в системе Apple соответствует 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.
В ios/utils/RuntimeError.hpp у Nitro есть маленькая функция:
static inline std::exception_ptr makeException(const std::string& message) {
return std::make_exception_ptr(std::runtime_error(message));
}Её вызывает Swift-код Nitro (RuntimeError.swift) через C++ interop. Моё объяснение такое: при сборке через Swift эта inline-функция компилируется без проверки доступности libc++ и сразу ссылается на новую функцию. В пользу этого говорит то, что в том же Nitro make_exception_ptr вызывается ещё в двух местах (Promise.hpp, JSIConverter+Exception.hpp), но они собираются обычным clang и символ не тянут. Все поды при этом собраны под 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_pointerВ 2.0 (69) было 1, в исправленной сборке 0. Симулятора с iOS 16 или 17 у меня не было, поэтому проверка статическая: смотрю, на что ссылается бинарник, а не запускаю его на старой системе.
Ещё одни грабли: пробел в пути#
Первый архив с исправлением упал на шаге сборки JS-бандла:
/bin/sh: /Users/dodecaidr/Desktop/My: No such file or directoryСкрипт React Native в шаблоне проекта вызывает /bin/sh -c "$WITH_ENVIRONMENT $REACT_NATIVE_XCODE" без кавычек вокруг путей, а проект лежит в папке «My Progect». Я собирал архив из копии проекта в папке без пробелов и передавал REACT_NATIVE_PATH на копию.
Выпуск 2.0.1 и срочная проверка#
Дальше всё стандартно: поднял версию до 2.0.1 и сборку до 70 в Info.plist приложения и виджета, загрузил сборку, заполнил «Что нового» во всех восьми локализациях и поставил автоматический выпуск после одобрения. Пока пишу эту статью, версия на проверке.
Для таких случаев у Apple есть форма срочной проверки. Подать её можно только после того, как версия отправлена на проверку. В форме нужно выбрать приложение и платформу, после отправки Apple сразу ответила, что проверку ускорят. Если версию отклонят, повторная отправка сама попадёт в ту же очередь.
Как не выпустить такую сборку снова#
Перед каждой загрузкой я прогоняю архив через свой скрипт проверки: тексты разрешений, манифест приватности, версии расширений. Туда добавилась ещё одна проверка: если минимальная версия ниже 18, скрипт ищет в бинарниках __from_native_exception_pointer, __cxa_init_primary_exception и ещё пару символов из новой libc++. На старом архиве 2.0 (69) он нашёл сразу два, второй я до этого не видел: dyld сообщает только о первом отсутствующем символе. На архиве 2.0.1 ошибок ноль.
Короткая версия для своего проекта, если в нём есть Swift-код с C++ interop или поды вроде Nitro:
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 проверяет после загрузки, разобрано в статье про правила App Review октября 2026.



