React Native iOS pod install报Invalid Podfile错误解决

报错核心原因是use_native_modules!执行时依赖的自动链接脚本无法正确解析项目路径，本质是CLI依赖版本不兼容、Podfile配置错误或缓存残留导致，按以下步骤逐一排查修复：

1. 修复CLI依赖版本不匹配问题 #

你的项目使用React Native 0.61.3，对应适配的@react-native-community/cli-platform-ios版本为2.x系列，当前安装的^3.0.0为跨大版本不兼容版本，是该报错的最高发诱因。
执行以下命令替换为匹配版本：

npm uninstall @react-native-community/cli-platform-ios
npm install @react-native-community/cli-platform-ios@2.9.0 -D

CLI类工具依赖统一放在devDependencies节点下，不要放在生产依赖dependencies中

2. 修正Podfile配置 #

RN0.61版本的自动链接逻辑已经内置在react-native依赖中，不需要手动在Podfile头部引入cli-platform-ios下的native_modules脚本，手动引入不匹配版本的脚本会直接触发路径解析为undefined的错误。
将Podfile修改为如下内容：

# Uncomment the next line to define a global platform for your project
platform :ios, '11.0'

target 'MyApp' do
  # Comment the next line if you don't want to use dynamic frameworks
  use_frameworks!

  # Pods for MyApp

  use_native_modules!
end

直接删除原Podfile中require_relative '../node_modules/@react-native-community/cli-platform-ios/native_modules'这一行即可

3. 全量清理缓存后重装依赖 #

配置和版本修正后，必须清理旧的安装缓存和产物，避免历史文件干扰执行：

# 清理JS端依赖
rm -rf node_modules package-lock.json
npm install

# 清理iOS端Pods依赖
cd ios
rm -rf Pods Podfile.lock
pod deintegrate
pod install

注意执行命令时进入的是全小写的ios目录，不要使用大写iOS作为路径名，开启大小写敏感的磁盘会直接触发路径解析错误

4. 残留问题排查 #

如果以上步骤执行后仍报错，逐个校验以下点：

• 检查项目完整路径是否包含中文、空格、特殊字符，这类字符会导致Node脚本解析路径失败，返回undefined
• 校验第三方原生依赖版本适配性：当前依赖中@react-native-community/netinfo@8.3.0、react-native-push-notification@^8.1.1、react-redux@^8.0.2等版本远高于RN0.61的适配范围，高版本依赖修改的autolink逻辑也会导致use_native_modules执行失败，可逐个降级到适配RN0.61的版本验证：
  • @react-native-community/netinfo 适配版本为^5.0.0
  • react-native-push-notification 适配版本为^5.0.0
  • react-redux 适配版本为^7.x系列
• 检查本地Node版本，RN0.61适配Node 10/12系列，过高的Node版本（16+）会导致旧版CLI脚本执行异常，可切换到Node 12.x版本重试。

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