React Native(IOS) debug模式卡在闪屏抛出NSException问题排查求助

核心问题根因 #

你崩溃的直接原因是错误移除了Other Linker Flags中的-ObjC标记：
React Native大量核心逻辑依赖Objective-C分类实现，-ObjC标记的作用是让链接器加载所有Objective-C类和分类到最终二进制中，移除该标记后，链接器会自动裁剪未识别到引用的分类方法，其中就包括RCTRootView的reactTag分类方法，进而触发unrecognized selector崩溃。

你最初遇到的178个x86_64架构重复符号问题，才是需要优先解决的问题，不要用删除-ObjC的方式绕路。

排查解决步骤 #

1. 把-ObjC标记加回Target的Other Linker Flags配置中。
2. 定位重复符号来源：
   • 点开Xcode编译错误的详细日志，查看重复符号对应的具体类，绝大多数情况下是React Native核心库/第三方原生依赖被重复引入导致。
   • 检查项目Build Phases下的Compile Sources和Link Binary With Libraries列表，删除重复添加的RN相关.a静态库（手动集成RN 0.59版本时极易出现该问题）。
   • 确认没有同时通过手动拖拽和CocoaPods引入同一套RN依赖，你提到添加pod后无依赖引入，是因为0.59版本的RN需要在Podfile中手动声明所有RN子库的subspec才能正常集成。
3. 如果排查后仍有第三方库导致的重复符号，可以不用全局加-ObjC，改为强制加载RN相关静态库：将Other Linker Flags中的-ObjC替换为-force_load $(BUILT_PRODUCTS_DIR)/libReact.a，并按实际使用情况添加其他RN子库的-force_load规则，既可以避免第三方库重复符号问题，也能保证RN的分类方法被正常链接。
4. 清理所有缓存后重新编译：删除Xcode的DerivedData目录，删除项目下的node_modules重新执行安装，再执行react-native link --reset重置原生依赖链接。

Release模式表现说明 #

你遇到的Release模式下代码修改不生效、无console输出、无法Safari调试均为预期行为：Release模式默认会打包离线JSBundle，关闭所有JS调试能力、裁剪日志输出，不需要依赖本地metro bundler运行。

内容的提问来源于stack exchange，提问作者pallavi khedle