React Native 0.73.2 iOS端因FlipperKit构建失败求助

问题说明 #

React Native 0.73.2版本，Android端构建无问题，但iOS端测试构建时失败，报错如下：

The following build commands failed:
        CompileC /Users/user257599/Library/Developer/Xcode/DerivedData/###-cagfttfeertkgidamqciuaveliuz/Build/Intermediates.noindex/Pods.build/Debug-iphonesimulator/FlipperKit.build/Objects-normal/arm64/FlipperPlatformWebSocket.o /Users/user257599/Documents/###/###/ios/Pods/FlipperKit/iOS/FlipperKit/FlipperPlatformWebSocket.mm normal arm64 objective-c++ com.apple.compilers.llvm.clang.1_0.compiler (in target 'FlipperKit' from project 'Pods')
(1 failure)

已尝试pod update，问题未解决。

可行解决方案 #

1. 彻底清理iOS构建缓存 #

进入项目的ios目录，依次执行以下命令：

rm -rf Pods Podfile.lock
rm -rf ~/Library/Developer/Xcode/DerivedData
pod install --repo-update

完成后重启Xcode，按下Cmd+Shift+K清理当前构建，再重新尝试编译。

2. 指定兼容的Flipper版本 #

React Native 0.73.x对Flipper版本有明确兼容要求，在ios/Podfile中找到Flipper配置代码，修改为指定版本：

use_flipper!({ 'Flipper' => '0.202.0' })

修改完成后执行pod install，重新构建项目。

3. 临时禁用Flipper（非调试场景可选） #

如果不需要Flipper调试工具，可直接禁用：

• 在ios/Podfile中注释掉use_flipper!相关代码
• 执行pod install
• 打开AppDelegate.mm，注释或删除Flipper初始化相关代码

4. 调整Xcode架构设置 #

• 打开Xcode项目，选中你的App target，进入Build Settings面板
• 搜索Architectures，确保设置为Standard Architectures (arm64, x86_64)
• 搜索Excluded Architectures，在Debug模式下添加arm64（针对模拟器场景）

5. 更新依赖工具 #

确保Xcode版本为15.0及以上（React Native 0.73的最低要求），同时更新Homebrew及相关依赖：

brew update && brew upgrade

内容的提问来源于stack exchange，提问作者Ben H