Yarn install无法从远程仓库拉取依赖，解压失败报错求助

安全阿岳

2026-7-6

解决Yarn 3.1执行yarn install时的Brotli解压失败报错

问题背景

执行yarn install时遇到如下解压失败报错：

➤ YN0001: │ Error: Decompression failed
    at BrotliDecoder.zlibOnError [as onerror] (node:zlib:190:17)
    at processChunkSync (node:zlib:459:12)
    at zlibBufferSync (node:zlib:178:12)
    at Object.syncBufferWrapper [as brotliDecompressSync] (node:zlib:794:14)
    at h_.exports.getContent (/Users/X/app/.yarn/releases/yarn-3.1.0.cjs:198:58091)
    at Object.lTe (/Users/X/app/.yarn/releases/yarn-3.1.0.cjs:426:3890)
    at runMicrotasks (<anonymous>)
    at processTicksAndRejections (node:internal/process/task_queues:96:5)
    at async Vs.fetchFromNetwork (/Users/x/app/.yarn/releases/yarn-3.1.0.cjs:695:23730)
    at async p (/Users/X/app/.yarn/releases/yarn-3.1.0.cjs:432:1305)

已尝试删除node_modules和yarn.lock重新安装，切换Yarn v4虽能完成安装但后续构建失败，需保留Yarn 3.1版本解决问题。

解决方案

清理Yarn缓存：缓存的依赖压缩包可能已损坏，执行缓存清理：
```
yarn cache clean
```
匹配兼容的Node.js版本：Yarn 3.1对Node.js 14.x-16.x兼容性最佳，若当前Node版本过高，使用版本管理工具切换（如nvm）：
```
nvm use 16
```
禁用Brotli解压：报错源于Brotli解码故障，在项目根目录的.yarnrc.yml中添加以下配置，强制使用其他解压方式：
```
httpOptions:
  disableBrotli: true
```
重新执行安装：
```
yarn install
```