React Native项目跨机器构建失败：依赖组件无法解析

针对克隆项目后执行npm install无法找到com.facebook.react:react-android和com.facebook.react:hermes-android依赖，但复制原机器node_modules即可正常运行的问题，可尝试以下解决方案：

1. 统一包管理器版本 #

不同机器的npm/yarn版本差异可能导致依赖安装不一致。执行命令对比版本：

npm -v
# 若使用yarn则执行
yarn -v

将新机器的包管理器版本调整为与原机器一致，再重新执行依赖安装。

2. 清理缓存并重新安装 #

缓存或损坏的锁文件可能导致依赖安装不完整：

• 清理npm缓存：

  npm cache clean --force
  

• 删除本地依赖文件：

  # macOS/Linux
  rm -rf node_modules package-lock.json
  # Windows
  rmdir /s /q node_modules && del package-lock.json
  

• 重新安装依赖：

  npm install
  

3. 检查Android构建仓库配置 #

React Native 0.70.x需要确保android/build.gradle中的仓库配置正确，在allprojects.repositories节点下添加以下内容：

maven {
    url "$rootDir/../node_modules/react-native/android"
}
maven {
    url "$rootDir/../node_modules/jsc-android/dist"
}
maven { url "https://www.jitpack.io" }

该配置会引导Gradle从本地node_modules中读取React Native相关依赖。

4. 验证Hermes配置 #

如果项目启用了Hermes，确认android/app/build.gradle中的配置正确：

project.ext.react = [
    enableHermes: true, // 若项目未启用Hermes则设为false
]

启用Hermes后，Gradle会自动从node_modules中引入hermes-android依赖，无需手动添加。

5. 锁定依赖版本 #

将原机器的package-lock.json（或yarn.lock）推送到代码仓库，新机器克隆后执行npm install时会安装与原机器完全一致的依赖版本，避免版本差异问题。

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