WhatsApp-Web.js重装失败求助:Puppeteer证书及版本警告
解决whatsapp-web.js安装时的TLS证书错误与Chromium下载失败问题
问题根源
- 你使用的旧版
puppeteer@13.7.0已被废弃,且下载依赖的Chromium时,当前npm.taobao.org的SSL证书域名不匹配,导致TLS验证失败。 - 降级npm无法解决证书和旧依赖的核心问题。
具体解决步骤
1. 修复npm源的证书问题
旧的淘宝源npm.taobao.org已停止维护,证书不再匹配,需切换到有效源:
- 切换到官方npm源:
npm config set registry https://registry.npmjs.org/ - 或使用国内新的淘宝镜像源:
npm config set registry https://registry.npmmirror.com/
2. 跳过Chromium下载(快速解决)
如果本地已安装Chrome或Chromium,可跳过下载步骤:
- Windows命令行执行:
set PUPPETEER_SKIP_DOWNLOAD=true npm install whatsapp-web.js - 安装完成后,在代码中指定本地浏览器路径:
const { Client } = require('whatsapp-web.js'); const client = new Client({ puppeteer: { executablePath: 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe' // 替换为你的实际路径 } });
3. 升级whatsapp-web.js到最新版本
新版本会依赖更兼容的puppeteer版本,从根源避免旧依赖问题:
npm install whatsapp-web.js@latest
升级后若仍有下载问题,可结合步骤2的PUPPETEER_SKIP_DOWNLOAD环境变量。
4. 清理缓存后重新安装(可选)
如果之前的缓存导致异常,执行以下操作:
npm cache clean --force
删除本地依赖文件:
- Linux/macOS:
rm -rf node_modules package-lock.json - Windows:
rmdir /s node_modules del package-lock.json
之后重新执行npm install whatsapp-web.js。
内容的提问来源于stack exchange,提问作者lady
相关产品推荐
相关产品推荐

