iOS归档发布App Store时遇ld: library not found for -lReact-RCTVibration错误求助

核心问题分析 #

从报错信息来看，归档阶段的Release-iphoneos目录下找不到React-RCTVibration和react-native-safe-area-context的库文件，说明构建产物路径或依赖配置在归档模式下存在异常。

分步解决方法 #

1. 彻底清理缓存与依赖 #

关闭Xcode，执行以下命令清理所有冗余缓存和依赖：

# 清理Xcode全局构建缓存
rm -rf ~/Library/Developer/Xcode/DerivedData
# 清理项目本地依赖
rm -rf node_modules
rm Podfile.lock
rm -rf ios/Pods

重新安装依赖：

npm install
cd ios && pod install --repo-update

2. 修正Xcode Build Settings配置 #

打开Xcode选中项目target，进入Build Settings标签：

• 搜索Library Search Paths，删除所有无效的绝对路径（比如报错里的DerivedData路径），保留$(inherited)以继承Pod的自动配置。
• 搜索Other Linker Flags，确保包含$(inherited)，避免手动添加的链接规则覆盖Pod的默认配置。

3. 优化Podfile配置 #

• 移除Podfile中手动添加的pod 'React-RCTVibration'，use_react_native!会自动引入官方核心库，手动添加易引发冲突。
• 检查ios/Pods/Podfile.lock，确认react-native-safe-area-context已被正确引入，若缺失则执行npx pod-install重新同步依赖。

4. 清理Build Phases冗余配置 #

进入Build Phases -> Link Binary With Libraries：

• 移除手动添加的React-RCTVibration相关库，Pod会自动管理核心库的链接，重复添加会导致路径冲突。
• 确认react-native-safe-area-context的库文件已自动关联，若缺失可重新执行pod install让Pod自动添加。

5. 统一构建路径设置 #

打开Xcode的File -> Project Settings，将Build Location设置为Custom并选择Relative to Workspace，避免DerivedData路径异常导致的库文件找不到问题。

6. 预验证Release构建 #

先选择任意iOS设备，执行Product -> Build For -> Archiving，确认构建成功后再正式执行归档操作，提前排查构建阶段的潜在问题。

内容的提问来源于stack exchange，提问作者Bigyan Karki