全局安装Puppeteer报ENOTFOUND storage.googleapis.com错误求助

问题复现场景 #

• 执行全局安装命令npm i --location=global puppeteer、npm install -g puppeteer均触发相同报错
• 此前Puppeteer曾安装成功且可正常运行代码，间隔1天后出现该问题，已尝试公开可查的所有相关方案均未解决
• 完整报错信息如下：

C:\windows\system32>npm install -g puppeteer
npm ERR! code 1
npm ERR! path C:\Users\NITU PANDEL\AppData\Roaming\npm\node_modules\puppeteer
npm ERR! command failed
npm ERR! command C:\windows\system32\cmd.exe /d /s /c C:\Users\NITUPA~1\AppData\Local\Temp\install6572787965.cmd
npm ERR! ERROR: Failed to set up Chromium r1011831! Set "PUPPETEER_SKIP_DOWNLOAD" env variable to skip download.
npm ERR! Error: getaddrinfo ENOTFOUND storage.googleapis.com
npm ERR!     at GetAddrInfoReqWrap.onlookup [as oncomplete] (node:dns:71:26) {
npm ERR!   errno: -3008,
npm ERR!   code: 'ENOTFOUND',
npm ERR!   syscall: 'getaddrinfo',
npm ERR!   hostname: 'storage.googleapis.com'
npm ERR! }

npm ERR! A complete log of this run can be found in:
npm ERR!     C:\Users\NITU PANDEL\AppData\Local\npm-cache\_logs\2022-07-08T11_02_45_016Z-debug-0.log

故障原因 #

报错核心是本地网络无法解析Puppeteer默认的Chromium下载域名storage.googleapis.com，安装流程卡在Chromium二进制包下载环节直接退出。此前安装成功是当时网络可正常连通该域名，后续DNS配置变动、网络访问规则调整都会导致解析失败。

修复操作 #

按顺序执行以下操作即可完成安装：

1. 配置临时环境变量跳过默认下载流程，在当前打开的cmd窗口执行：

   set PUPPETEER_SKIP_DOWNLOAD=true
   

   *如果需要长期生效，直接在Windows系统环境变量面板新增同名系统变量，值设为true即可。
2. 配置Puppeteer可用的下载镜像源，执行npm配置命令：

   npm config set puppeteer_download_host https://npmmirror.com/mirrors
   

3. 重新执行全局安装命令：

   npm install -g puppeteer
   

4. 单独安装适配版本的Chromium，此时会从已配置的镜像源拉取资源，不会请求无法解析的谷歌域名：

   npx puppeteer browsers install chrome
   

安装完成后可直接运行原有Puppeteer代码验证，能正常拉起浏览器页面即修复完成。

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