React Native项目Archive打包时出现Undefined symbols for architecture arm64错误求助
解决React Native Archive打包时「Undefined symbols for architecture arm64」错误
排查与修复步骤
清理缓存与构建文件
关闭Xcode,执行以下命令彻底清理:rm -rf ~/Library/Developer/Xcode/DerivedData cd 你的项目根目录 rm -rf ios/build pod deintegrate && pod install重新打开Xcode,按
Cmd+Shift+K清理构建文件夹,再尝试Archive。统一Xcode架构配置
- 打开项目Target的
Build Settings:- 将
Architectures设为Standard Architectures (arm64),Release模式下取消勾选Build Active Architecture Only。 - 找到
Valid Architectures,添加arm64(若未存在)。
- 将
- 进入Pods项目,对所有依赖库的Target重复上述架构配置检查,确保一致。
- 打开项目Target的
修复第三方依赖兼容性
该错误通常由第三方库的架构不兼容导致:- 确认项目中所有Native依赖库支持arm64,且适配React Native 0.71.6版本,老旧库优先升级。
- 若无法升级问题库,在Podfile中添加针对性配置:
post_install do |installer| installer.pods_project.targets.each do |target| # 替换为出现问题的库名称 if target.name == 'TargetLibraryName' target.build_configurations.each do |config| config.build_settings['EXCLUDED_ARCHS[sdk=iphonesimulator*]'] = 'arm64' config.build_settings['VALID_ARCHS'] = 'arm64' end end end end
执行
pod install后重新打包。检查链接配置
进入项目Target的Build Phases->Link Binary With Libraries,确认所有必要的依赖库(如React相关库)已正确添加,缺失则手动补充。调整编译选项
在Build Settings中:- 将
Dead Code Stripping设为YES(仅Release模式)。 - 检查
Other Linker Flags,确保包含-ObjC(部分第三方库需要该配置)。
- 将
内容的提问来源于stack exchange,提问作者Sukanta Samanta
相关产品推荐
相关产品推荐

