El error dyld symbol not found apareció en la versión 2.0 de mi app LadyFly así: en iPhone con iOS 16 y 17 la app se cerraba al abrir, antes de la primera pantalla. Con iOS 18 y posteriores todo iba bien. Me enteré dos días después del lanzamiento, por el contador de fallos de App Store Connect. Abajo, paso a paso: dónde encontrar los informes, cómo dar con la biblioteca que arrastra el símbolo que falta y cómo lo resolvió un solo cambio en el Podfile.
Entorno: Xcode 27.1, SDK de iOS 27.1, React Native 0.81.4, react-native-nitro-modules 0.29.6, objetivo de despliegue mínimo iOS 15.1.
Dónde ver los fallos al abrir#
App Store Connect. En el resumen de Analytics hay una tarjeta "Fallos por versión de la app". La versión 2.0 mostraba 8; la anterior, la 1.13, tuvo uno en 90 días. En Métricas, con los fallos agrupados por versión de la plataforma, los ocho eran de iOS 17.6, todos en los dos días siguientes al lanzamiento. Estas cifras solo vienen de quienes comparten los diagnósticos, así que el número real es mayor.
El panel web no tiene trazas de pila, solo recuentos.
Crashes en Xcode Organizer. Los informes completos están en Xcode: Window → Organizer → Crashes, elige la app a la izquierda, versión 2.0. Xcode descargó cinco informes de tres dispositivos y los agrupó como NO_CRASH_STACK. Después los archivos quedan en el disco, y se leen mejor desde la terminal:
~/Library/Developer/Xcode/Products/<bundle id>/Crashes/Points/*/Filters/*/Logs/*.crashQué decía el informe: dyld symbol not found en libc++#
Los cinco informes eran idénticos, un iPhone 8 con 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 significa que el cargador dyld no encontró en una biblioteca del sistema una función a la que el binario hace referencia, y mató el proceso antes de main. Por eso tampoco hay pila: ningún código de la app se había ejecutado aún.
Pasado por c++filt, el símbolo se lee std::exception_ptr::__from_native_exception_pointer(void*). Es una función de libc++, la biblioteca estándar de C++ en iOS.
Mi primera hipótesis era errónea#
La versión 2.0 añadió frameworks que el iOS antiguo no tiene: FoundationModels para las sugerencias de fotos (iOS 26+), Translation y ActivityKit. Sospeché de ellos primero y revisé el archivo:
otool -l LadyFly.app/LadyFly | grep -A2 LC_LOAD_WEAK_DYLIBLos tres están enlazados como LC_LOAD_WEAK_DYLIB, es decir, opcionales, y su código está detrás de #available. Si ellos fueran el problema, el informe nombraría el framework, no libc++.
Qué versión de iOS necesita este símbolo#
Lo respondieron las cabeceras del SDK. En usr/include/c++/v1/__configuration/availability.h la función está marcada con _LIBCPP_INTRODUCED_IN_LLVM_18, y en las plataformas de Apple LLVM 18 corresponde a iOS 18. La libc++ del sistema en iOS 16 y 17 es más antigua y no la tiene.
Normalmente eso es inofensivo. Con un objetivo de despliegue inferior a 18, clang ve la marca y compila std::make_exception_ptr por el camino antiguo de throw/catch, sin la función nueva. Así que alguna parte del código se había compilado saltándose esa comprobación.
Cómo encontrar la biblioteca que arrastra el símbolo#
El binario de la app se enlaza a partir de decenas de bibliotecas estáticas de CocoaPods. Los .a intermedios quedan en DerivedData tras compilar el archivo, y nm -u muestra qué archivo objeto referencia el símbolo:
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
doneUn solo resultado: libNitroModules.a:RuntimeError.o. Nitro Modules es la capa nativa sobre la que funciona react-native-unistyles en LadyFly.
El ios/utils/RuntimeError.hpp de Nitro tiene una función pequeña:
static inline std::exception_ptr makeException(const std::string& message) {
return std::make_exception_ptr(std::runtime_error(message));
}El código Swift de Nitro (RuntimeError.swift) la llama mediante la interoperabilidad con C++. Mi explicación: cuando esta función inline se compila del lado de Swift, se omite la comprobación de disponibilidad de libc++ y enlaza directamente la función nueva. Lo que la respalda: Nitro llama a make_exception_ptr en otros dos sitios (Promise.hpp, JSIConverter+Exception.hpp), pero esos los compila clang a secas y no arrastran el símbolo. Todos los pods se compilaron para iOS 15.1, así que la causa no era el objetivo de despliegue.
La corrección en el Podfile#
makeException tiene que construir el exception_ptr sin la función nueva. Una forma que sirve con cualquier libc++: lanzar la excepción y capturarla.
try {
throw std::runtime_error(message);
} catch (...) {
return std::current_exception();
}Editar node_modules a mano no sirve de nada: el cambio desaparece en la siguiente instalación. El proyecto ya tenía un hook post_install que parchea del mismo modo una cabecera de la biblioteca fmt, así que añadí un segundo parche a su lado:
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
endTras pod install y compilar el archivo, comprobé el binario:
nm -u LadyFly.app/LadyFly | grep -c from_native_exception_pointerLa 2.0 (69) dio 1; la compilación corregida, 0. No tenía un simulador de iOS 16 ni 17, así que es una comprobación estática: miro a qué hace referencia el binario, no lo ejecuté en un sistema antiguo.
Otra trampa: un espacio en la ruta#
El primer archivo con la corrección falló al empaquetar el JS:
/bin/sh: /Users/dodecaidr/Desktop/My: No such file or directoryEl script de compilación de la plantilla de React Native llama a /bin/sh -c "$WITH_ENVIRONMENT $REACT_NATIVE_XCODE" sin entrecomillar las rutas, y el proyecto vive en una carpeta llamada "My Progect". Compilé el archivo desde una copia del proyecto en una carpeta sin espacios y apunté REACT_NATIVE_PATH a la copia.
Publicar la 2.0.1 con revisión acelerada#
El resto fue rutina: subí la versión a 2.0.1 y la compilación a 70 en el Info.plist de la app y del widget, envié la compilación, rellené "Novedades" en las ocho localizaciones y fijé que la publicación sea automática tras la aprobación. Mientras escribo esto, la versión está en revisión.
Apple tiene un formulario justo para esta situación: solicitar una revisión acelerada. Solo funciona cuando la versión ya se ha enviado a revisión. Eliges la app y la plataforma; al enviarlo, Apple confirmó enseguida que la revisión sería acelerada. Si la versión se rechaza, el reenvío vuelve a la misma cola por sí solo.
Cómo no volver a publicar una compilación así#
Antes de cada subida paso el archivo por mi propio script de comprobación: textos de permisos, manifiesto de privacidad, versiones de las extensiones. Ahora tiene una comprobación más: cuando el objetivo de despliegue es inferior a 18, busca __from_native_exception_pointer, __cxa_init_primary_exception y un par de símbolos más de la libc++ nueva. En el archivo antiguo de la 2.0 (69) encontró dos a la vez; el segundo no lo había visto, porque dyld solo informa del primer símbolo que falta. En el archivo de la 2.0.1, cero errores.
La versión corta para tu proyecto, si tiene código Swift con interoperabilidad con C++ o pods como Nitro:
nm -u Payload/App.app/App | grep -E 'from_native_exception_pointer|cxa_init_primary_exception'Si no sale nada, el cargador no tropezará con estos símbolos en iOS 15–17. Si compilas las versiones en la nube, esta línea cabe en ci_post_xcodebuild.sh; de esos scripts hablo más en mi guía de Xcode Cloud. Y lo que revisa App Review después de la subida está en el artículo sobre las guías de App Review de octubre de 2026.



