React Native运行pod install报UMFileSystemInterface依赖错误如何解决

开发者阿泽

2026-10-7

问题修复步骤

该报错本质是expo-av（iOS端模块名为EXAV）依赖的unimodules基础接口组件未被正确检索到，可按以下顺序排查修复：

清理全链路依赖缓存
先删除项目根目录的依赖文件与锁文件，重新安装npm依赖：
```
rm -rf node_modules package-lock.json yarn.lock
npm install
```
再进入ios目录清理cocoapods相关缓存：
```
cd ios
rm -rf Pods Podfile.lock
pod deintegrate
pod cache clean --all
```
修正Podfile的配置顺序
你当前Podfile中use_unimodules!与use_native_modules!的加载顺序错误，需调整为use_native_modules!在前，use_unimodules!在后，修改后对应代码段如下：
```
config = use_native_modules!
use_unimodules! 
```
注意：unimodules的注册需要在原生模块配置完成后执行，否则CocoaPods会无法检索到UM开头的基础依赖组件
校验依赖版本兼容性
若项目中安装的expo-av版本与react-native-unimodules版本不匹配，也会触发该依赖查找失败问题。可将expo-av降级到与当前unimodules适配的版本，比如unimodules 0.14.x版本对应兼容expo-av ~9.2.3，重新安装对应版本依赖后再执行pod安装即可。
更新本地CocoaPods源
执行以下命令更新本地cocoapods的官方源：
```
pod repo update
```
完成后回到项目根目录执行npx pod-install即可。