运行npx react-native start时报Module not found错误如何解决？

解决方案 #

第一步：清理损坏的依赖锁与缓存 #

• 删除项目根目录下的node_modules文件夹、package-lock.json文件（未删除锁文件会导致每次安装都复用旧的错误依赖配置）
• 执行npm缓存清理命令：npm cache clean --force
• 全局卸载已安装的cli工具，避免多版本冲突：

  npm uninstall -g react-native-cli @react-native-community/cli
  

第二步：修复Java版本环境变量配置 #

React Native 0.68及以上版本默认适配JDK11，低于该版本适配JDK8，你设备上同时存在两个版本JDK，需按项目版本匹配对应环境变量：

• 右键「此电脑」-「属性」-「高级系统设置」-「环境变量」
• 在系统变量中找到JAVA_HOME，将值修改为对应版本JDK的安装根路径
• 打开新的命令行窗口执行java -version，确认版本配置生效

第三步：重新安装依赖并启动 #

• 回到项目根目录执行npm install，项目会自动安装匹配版本的本地react-native cli，无需额外全局安装
• 安装完成后确认node_modules/@react-native-community/cli/build/bin.js文件存在
• 执行启动命令即可，安卓端启动命令为npx react-native run-android

兜底适配方案 #

如果执行上述步骤后仍然提示路径错误，直接在项目package.json的scripts字段中添加指定cli路径的自定义启动命令：

"scripts": {
  "android": "node node_modules/@react-native-community/cli/build/bin.js run-android",
  "ios": "node node_modules/@react-native-community/cli/build/bin.js run-ios"
}

后续直接用npm run android命令启动项目即可。

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