旧版React Native(v0.61.5)应用构建报错及升级至最新版方案咨询

一、先搞定当前v0.61.5的构建问题 #

1. 清理手动关联残留（核心原因：RN0.60+默认自动链接，手动配置冲突） #

iOS端操作：

• 打开ios/Podfile，删掉手动添加的react-native-fcm、@react-native-community/netinfo相关pod配置
• 打开Xcode项目工作区，移除这两个依赖的手动引入工程（比如RNFIRMessaging.xcodeproj），再删除Link Binary With Libraries中对应的库文件
• 执行命令：cd ios && pod deintegrate && pod install

Android端操作：

• 打开android/settings.gradle，删掉手动添加的include ':react-native-fcm'、include ':react-native-netinfo'及对应的路径配置
• 打开android/app/build.gradle，移除dependencies中的implementation project(':react-native-fcm')、implementation project(':react-native-netinfo')
• 打开MainApplication.java，删掉这两个依赖的import语句和getPackages()里的注册代码
• 执行命令：cd android && ./gradlew clean

2. 锁定兼容的依赖版本 #

修改package.json，确保依赖版本适配RN0.61.5：

• react-native-fcm：指定版本^16.2.4（注意该库已废弃，迁移时必须替换）
• @react-native-community/netinfo：指定版本^5.9.7

3. 重新构建项目 #

• iOS：在Xcode中按Cmd+Shift+K清理缓存后编译，或执行npx react-native run-ios
• Android：执行npx react-native run-android

二、迁移至React Native最新版本 #

1. 前置准备 #

• 提交所有代码到Git做备份，避免迁移过程中丢失内容
• 升级本地开发环境：Node.js≥18、JDK17、Xcode≥14.3（iOS）、Android Studio Hedgehog及以上版本（Android）

2. 借助官方升级助手分步迁移 #

1. 执行npx react-native upgrade-helper，选择当前版本0.61.5和目标最新版本，生成配置差异报告
2. 按报告更新配置与依赖：
   • 更新package.json中的react、react-native版本，同时替换废弃依赖：
     • 卸载react-native-fcm，安装官方Firebase库：npm install @react-native-firebase/app @react-native-firebase/messaging，并按Firebase文档配置iOS/Android项目
     • RN0.68+已将NetInfo并入核心，直接卸载@react-native-community/netinfo，代码中替换为import { NetInfo } from 'react-native'（最新版推荐使用useNetInfo Hook）
   • 更新android/build.gradle、android/app/build.gradle、ios/Podfile的版本结构与配置项
3. 修复代码兼容性：
   • 替换废弃API：比如将AsyncStorage替换为@react-native-async-storage/async-storage，调整组件生命周期方法等
   • 执行npx react-native doctor检测环境与依赖问题，修复所有报错
4. 重新安装依赖并构建：
   • 删除node_modules、package-lock.json，执行npm install
   • iOS：cd ios && pod install && npx react-native run-ios
   • Android：cd android && ./gradlew clean && npx react-native run-android

3. 功能验证 #

测试推送通知、网络状态检测等核心功能，修复迁移过程中出现的兼容性bug

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