如何升级旧React Native项目的所有依赖库并解决编译问题？

第一步：锁定RN核心版本，排查依赖链路 #

• 先查看package.json里的react-native字段，固定当前RN核心版本（旧项目不建议贸然升级核心，避免引发更多兼容性问题）。
• 用npm ls <冲突依赖名>命令查看该依赖的引用链路，明确是哪个上层依赖拉取了不兼容的子版本，精准定位冲突源。

第二步：逐个处理废弃/冲突依赖 #

• 列出项目中已废弃的依赖（比如旧版react-native-fetch-blob、react-native-deprecated-custom-components等），替换为官方推荐的替代包：比如用RN原生fetch或axios替代react-native-fetch-blob。
• 针对版本冲突的依赖，优先尝试降级适配而非盲目升级：若A依赖要求lodash@^4.17.0，B依赖要求lodash@^3.0.0，可先将lodash固定到4.17.0，再查找B依赖支持该版本的旧版号，替换后重新安装。
• 修改依赖后，删除node_modules、package-lock.json，执行npm install --legacy-peer-deps（旧项目优先用此参数，适配npm7+严格的peer依赖规则）。

第三步：清理全链路缓存，排查编译细节 #

• 执行RN缓存清理：npx react-native clean，再清空npm缓存：npm cache clean --force。
• 针对iOS：进入ios目录，删除Podfile.lock，执行pod install --repo-update；针对Android：进入android目录，删除.gradle文件夹，执行./gradlew clean。
• 若仍编译失败，聚焦具体报错日志（Xcode/Gradle输出）：比如某依赖的原生代码不兼容当前RN版本，可尝试替换该依赖的适配版本，新手谨慎修改原生代码，优先找替代方案。

第四步：逐步验证，避免批量操作 #

• 不要一次性替换所有依赖，先解决导致npm install失败的核心冲突，每修复一个就执行一次npm install验证，确认成功后再处理下一个。
• 每次修改package.json后，先确保依赖安装成功，再尝试运行项目npx react-native run-ios/run-android。

第五步：兜底迁移方案 #

• 若上述方法均无效，可初始化一个与原项目同RN版本的空白项目，逐步迁移原项目的业务代码，同时只添加必要的依赖，彻底规避历史依赖的混乱问题。

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