执行npm i时Chromium下载及证书错误的解决方法

核心问题定位 #

安装失败的关键原因是puppeteer下载Chromium r722234时遭遇自签名证书链错误，另外存在core-js旧版本的废弃警告（不影响安装，可后续处理）。

方法一：快速跳过Chromium下载 #

直接按照报错提示设置环境变量跳过Chromium下载，确保npm install执行完成：

• Windows命令提示符（CMD）执行：

set PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=true && npm install

• Windows PowerShell执行：

$env:PUPPETEER_SKIP_CHROMIUM_DOWNLOAD="true"; npm install

后续如果需要使用puppeteer功能，再手动安装对应版本Chromium或配置使用本地已安装的Chrome浏览器。

方法二：解决证书链问题（需下载Chromium时用） #

临时关闭npm的严格SSL检查，绕过自签名证书限制：

1. 执行命令关闭严格SSL：

npm config set strict-ssl false

2. 重新执行安装：

npm install

3. 安装完成后建议恢复严格SSL（提升安全性）：

npm config set strict-ssl true

方法三：处理core-js废弃警告（可选） #

core-js@2.6.12已停止维护，可通过以下方式处理：

• 直接安装最新版core-js：

npm install core-js@latest --save

• 若升级后出现依赖冲突，可暂时忽略该警告，不影响项目基础运行。

额外优化：解决Docusaurus版本冲突 #

你的package.json中同时存在@docusaurus/core@2.x和docusaurus@1.x，两个版本可能引发依赖冲突，建议统一为v2版本：

npm uninstall docusaurus --save

卸载后重新执行npm install，减少潜在的运行时问题。

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