React Native iOS执行pod install时Podfile报错：configurations未定义

问题场景 #

在React Native项目中执行npx pod-install时扫描到Pods版本1.12.1，但执行pod install或pod install --repo-update均失败，报错指向iOS目录下Podfile第60行的use_native_modules!语句，错误信息为TypeError: Cannot read properties of undefined (reading 'configurations')，错误栈关联react-native-splash-screen模块。

解决步骤 #

1. 清理Node依赖与缓存 #

• 删除项目根目录的node_modules文件夹：

  rm -rf node_modules
  

• 清理包管理器缓存：

  # npm用户
  npm cache clean --force
  # yarn用户
  yarn cache clean
  

• 重新安装依赖：

  npm install
  # 或
  yarn install
  

2. 修复react-native-splash-screen模块问题 #

报错栈明确指向该模块，大概率是版本不兼容或安装异常：

• 卸载并重装模块：

  npm uninstall react-native-splash-screen
  npm install react-native-splash-screen
  

• 确认模块版本与当前React Native版本匹配：比如React Native 0.70+需使用react-native-splash-screen@3.3.0及以上版本，低版本RN需对应降级模块版本。

3. 彻底清理Pods相关文件 #

进入项目的ios目录执行以下操作：

cd ios
rm -rf Pods
rm Podfile.lock
pod cache clean --all
pod repo update
pod install

4. 检查Podfile配置正确性 #

• 确保Podfile顶部的RN相关导入语句正确：

  require_relative '../node_modules/react-native/scripts/react_native_pods'
  require_relative '../node_modules/@react-native-community/cli-platform-ios/native_modules'
  

• 确认use_native_modules!调用无错误，部分RN版本需指定路径：

  use_native_modules!(:path => "../node_modules")
  

5. 更新React Native CLI依赖 #

升级CLI相关包以修复潜在的配置读取bug：

npm install @react-native-community/cli@latest @react-native-community/cli-platform-ios@latest --save-dev

6. 验证Xcode项目完整性 #

如果以上步骤无效，打开iOS目录下的.xcworkspace文件：

• 检查项目Target的Build Settings中是否存在缺失的配置项
• 确认所有原生模块的链接状态正常（RN 0.60+支持自动链接，此步骤仅作备选）

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