执行Yarn install报esprima-fb包数据校验错误的问题咨询

问题排查与解决方案 #

你遇到的https://registry.npmjs.org/esprima-fb/-/esprima-fb-3001.0001.0000-dev-harmony-fb.tgz: incorrect data check报错本质是下载的依赖压缩包损坏，跨地区后网络环境、代理配置变动是核心诱因，很多跨区域办公的开发者都遇到过同类问题，可按以下步骤排查处理：

一、代理配置排查路径 #

• 首先检查yarn的代理配置：执行yarn config list，查看输出中的proxy、https-proxy字段，若存在已失效的比利时办公区旧代理配置，执行yarn config delete proxy、yarn config delete https-proxy清除，再按印度区VPN的要求配置正确的代理地址即可。
• 其次检查npm全局代理配置：执行npm config list，检查proxy、https-proxy、registry三个关键字段，部分依赖安装时会优先读取npm的全局配置，若印度节点访问npm官方源网速不稳定，可临时切换为国内镜像源测试：npm config set registry https://registry.npmmirror.com，验证问题解决后再切回公司内部源即可。
• 检查系统级代理配置：Windows系统查看系统代理设置，macOS/Linux系统执行echo $http_proxy $https_proxy $no_proxy查看环境变量，确认VPN连接后系统代理没有和npm/yarn的代理配置冲突，避免双重代理导致包下载被截断损坏。
• 检查项目本地配置：查看项目根目录下是否存在.npmrc、.yarnrc文件，确认文件中没有写死仅适用于比利时办公区的代理、私有源地址，这类本地配置跨区域后会直接失效。

二、临时修复方案 #

如果排查完代理配置后问题仍存在，可按顺序尝试以下操作：

1. 清理损坏缓存：执行yarn cache clean清除本地已缓存的损坏包，删除项目根目录下的node_modules文件夹和yarn.lock文件，重新执行yarn install。
2. 单独安装报错依赖：先执行yarn add esprima-fb@3001.0001.0000-dev-harmony-fb单独安装报错的依赖，安装成功后再执行全量安装。
3. 你提供的依赖中包含多个直接指向GitHub仓库的包，这类包走代理拉取的失败概率远高于npm源的包，若后续仍报同类错误，可手动下载对应GitHub包到本地，通过yarn add file:本地包路径的方式本地安装。

三、额外警告说明 #

你在印度区遇到的额外警告，大概率是跨国网络下部分依赖元数据拉取不完整、或者旧版本依赖和Node 12.20.0的兼容性提示，解决代理/源问题完成安装后，若警告不影响项目正常运行可暂时忽略，需要处理时再按警告内容逐个调整依赖版本即可。

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