React Native CLI下react-native run-ios触发iOS构建失败
React Native CLI iOS 构建Flipper编译失败 解决步骤
问题本质
报错指向的两个失败编译任务,均为Flipper SDK的核心C实现文件,触发原因是Xcode自带的Clang编译器版本,和项目拉取的旧版本Flipper SDK的C语法规则不兼容,多出现于升级Xcode到15及以上版本、项目未同步适配Flipper版本的场景。
按落地效率排序的操作步骤
1. 最快方案:开发阶段关闭Flipper
当前RN新版本的Hermes调试、网络监控、日志输出已经不依赖Flipper运行,关闭后完全不影响日常开发效率:
- 打开项目下的
ios/Podfile,定位到RN自动生成的use_flipper!配置行,修改为use_flipper!({ enabled: false }),跳过所有Flipper相关依赖的拉取和编译流程 - 清理残留的旧依赖与缓存:
- 删除
ios目录下的Pods文件夹 - 删除
ios目录下的Podfile.lock版本锁文件 - 清空Xcode全局构建缓存(即报错日志中指向的DerivedData目录),执行命令:
rm -rf ~/Library/Developer/Xcode/DerivedData/*
- 删除
- 进入
ios目录重新安装依赖:执行pod install --repo-update - 回到项目根目录重新执行
react-native run-ios启动模拟器
2. 需保留Flipper功能:升级适配版本的Flipper
如果项目确实需要使用Flipper的调试能力,直接在Podfile中指定兼容新Xcode的Flipper稳定版本,替换存在兼容问题的旧版编译代码:
- 在
ios/Podfile的use_flipper!配置中,替换为已修复Clang编译报错的兼容版本:use_flipper!({ 'Flipper' => '0.225.0' }) - 重复上述清缓存、重装Pod的流程完成配置
3. 补充排查项
- 检查Xcode命令行工具的绑定路径:执行
xcode-select -p确认输出指向当前使用的正式版Xcode安装路径,如果路径指向旧版Xcode、Beta版Xcode或独立的命令行工具目录,执行sudo xcode-select -s /Applications/Xcode.app/Contents/Developer重新绑定即可 - 避免强制使用x86_64架构编译模拟器包:旧版本Flipper的C++代码在x86_64编译目标下容易触发兼容报错,启动时指定arm64构建目标:
react-native run-ios --simulator "iPhone 15" --architecture arm64
内容的提问来源于stack exchange,提问作者Nikolay Khvan
相关产品推荐
相关产品推荐

