React Native项目Xcode构建报错：Lottie-ios文件缺失

报错原因 #

• Lottie-ios依赖出现非预期版本更新或结构变更：你看到node_modules里的Lottie文件新增前缀，说明依赖包的文件命名规则发生了变更，大概率是Logo合并操作触发了依赖自动更新，或者卸载react-native-bootsplash时间接修改了Lottie的依赖状态。
• Xcode构建缓存未同步：依赖文件结构变更后，Xcode仍在读取旧缓存指向原文件路径，导致找不到重命名后的文件。

问题来源 #

• 核心是Lottie-ios版本迭代中的命名空间调整：新版本的Lottie-ios可能把原有文件的前缀统一改成了「Lottie」，但项目的构建配置和缓存没跟上这个变化。
• 依赖管理的隐性操作：Logo合并过程中可能隐性执行了pod install或包管理器安装命令，意外把Lottie升级到了结构变更的版本；卸载react-native-bootsplash时的依赖清理也可能间接影响了Lottie的依赖完整性。

解决方法 #

1. 彻底重置依赖 #

• 删除本地依赖：rm -rf node_modules
• 重新安装JS依赖：yarn install 或 npm install
• 进入ios目录，清理旧Pod配置：pod deintegrate，再重新安装Pod：pod install

2. 清理Xcode缓存 #

• 关闭Xcode，执行rm -rf ~/Library/Developer/Xcode/DerivedData删除全局构建缓存
• 打开Xcode，按Cmd+Shift+K清理项目缓存，之后重新构建项目

3. 锁定Lottie依赖版本 #

• 在package.json里明确指定稳定版本的Lottie相关依赖，避免自动升级到结构变更的版本，示例：

  "dependencies": {
    "lottie-react-native": "5.1.6",
    "lottie-ios": "3.4.0"
  }
  

• 重新执行依赖安装和Pod安装操作

4. 检查Xcode构建配置 #

• 打开Xcode项目，进入Build Phases的Compile Sources列表，确认是否包含带「Lottie」前缀的.swift文件，要是缺失就手动从node_modules/lottie-ios目录里添加相关文件

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