部署React应用至Netlify时遭遇Yarn install错误

问题描述 #

将React App部署至Netlify时，构建阶段出现Error during Yarn install错误，尝试将构建命令从npm run build改为yarn run build后问题仍未解决。

解决步骤 #

• 统一Yarn版本
  本地项目使用的Yarn版本与Netlify构建环境版本可能不匹配，导致安装失败。可以在项目根目录添加.nvmrc文件指定Node版本，或者在Netlify部署设置的「环境变量」中添加YARN_VERSION，值设置为你本地使用的Yarn版本（例如1.22.19）。

• 清除构建缓存
  Netlify会缓存依赖包，缓存损坏可能引发安装问题。在Netlify部署页面的「部署设置」→「构建和部署」→「高级」中，点击「清除缓存并重新部署」，强制重新安装所有依赖。

• 校验依赖文件
  确保package.json无语法错误，依赖版本格式正确。本地执行yarn install后，将最新的yarn.lock文件提交至代码仓库，保证Netlify安装依赖时版本与本地一致。

• 配置依赖源
  若因网络问题无法下载依赖，可在Netlify环境变量中添加YARN_REGISTRY，值设为国内镜像源（例如https://registry.npmmirror.com），提升依赖下载成功率。

• 定位具体错误
  查看Netlify构建日志的详细输出，找到具体安装失败的依赖包，针对性调整该依赖的版本或替换为功能类似的依赖。

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