React Native从0.64.2升级至最新版本遇npm安装错误求助

1. 清理本地依赖环境 #

• 删除本地依赖目录和锁文件：

  # Mac/Linux
  rm -rf node_modules package-lock.json yarn.lock
  # Windows
  rd /s /q node_modules && del package-lock.json yarn.lock
  

• 清理npm缓存：

  npm cache clean --force
  

2. 手动修正package.json依赖版本 #

• 打开package.json，确保核心依赖版本匹配RN 0.72.1的要求：

  {
    "dependencies": {
      "react": "18.2.0",
      "react-native": "0.72.1"
    }
  }
  

• 检查第三方依赖的兼容性：逐个查看dependencies和devDependencies中的包，确认它们支持React 18.2.0和React Native 0.72.1。比如：
  • @react-navigation系列需升级到6.x及以上版本
  • react-native-safe-area-context需升级到4.5.x及以上版本
  • 若有依赖标注仅支持React 17.x，直接升级该包到最新兼容版本

3. 排查并解决peer依赖冲突 #

• 执行基础安装命令，查看具体冲突信息：

  npm install
  

• 若出现peer依赖错误，根据报错提示定位冲突包。例如报错xxx requires react@^17.0.0 but you have react@18.2.0，则升级该xxx包到支持React 18的版本。
• 重复执行npm install，直到无peer依赖错误为止。

4. 手动合并升级报告中的配置差异 #

• 参考react-native upgrade生成的升级报告，手动合并以下关键配置文件的差异：
  • Android：android/build.gradle、android/app/build.gradle、android/gradle/wrapper/gradle-wrapper.properties
  • iOS：ios/Podfile、ios/{项目名}.xcodeproj/project.pbxproj
• 注意保留项目自定义的配置（如签名信息、第三方插件配置），仅合并RN版本升级带来的必要变更。

5. 处理iOS Pod依赖（若涉及iOS项目） #

• 进入iOS目录，清理并重新安装Pod：

  cd ios
  pod deintegrate
  pod install --repo-update
  

6. 验证升级结果 #

• 重置缓存并启动项目：

  npx react-native start --reset-cache
  # 启动Android
  npx react-native run-android
  # 启动iOS
  npx react-native run-ios
  

• 确认项目能正常编译运行，且无需添加--legacy-peer-deps参数即可执行npm命令。

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