You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

WhatsApp-Web.js重装失败求助:Puppeteer证书及版本警告

解决whatsapp-web.js安装时的TLS证书错误与Chromium下载失败问题

问题根源

  1. 你使用的旧版puppeteer@13.7.0已被废弃,且下载依赖的Chromium时,当前npm.taobao.org的SSL证书域名不匹配,导致TLS验证失败。
  2. 降级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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.25 15:33:26