当使用 whatsapp-web.js 时，client.on('ready') 事件未触发，仅 qr 事件正常工作，通常由 SDK 版本缺陷导致；升级至修复分支（如 jkr_hotfix_7）可彻底解决该问题。
当使用 whatsapp-web.js 时，`client.on('ready')` 事件未触发，仅 `qr` 事件正常工作，通常由 sdk 版本缺陷导致；升级至修复分支（如 `jkr_hotfix_7`）可彻底解决该问题。
在基于 whatsapp-web.js 构建 WhatsApp 自动化应用时，开发者常遇到一个典型问题：二维码成功生成并扫码登录后，客户端始终无法进入就绪状态——即 ready 事件永不触发，导致后续消息发送、监听等逻辑无法执行。你提供的代码逻辑本身正确：
const { Client } = require('whatsapp-web.js');
const qrcode = require('qrcode-terminal');
const client = new Client();
client.on('qr', (qr) => {
qrcode.generate(qr, { small: true });
console.log('QR RECEIVED');
});
client.on('ready', () => {
console.log('Client is ready!'); // ← 此处日志从不输出
});
client.initialize();但问题根源并非代码错误，而是 whatsapp-web.js 主流 npm 版本（如 1.23.x 及更早）存在已知的会话状态同步缺陷：在完成 QR 扫码认证后，底层 Puppeteer 页面未能准确识别 WhatsApp Web 的“已登录”DOM 状态变化，导致 ready 事件监听器被跳过。
✅ 官方推荐解决方案（经验证有效）：
切换至社区维护的修复分支 —— jkr_hotfix_7，该分支专门修复了 ready 事件丢失、页面重载后状态错乱等问题：
# 1. 卸载当前版本 npm uninstall whatsapp-web.js # 2. 安装修复分支（直接引用 GitHub tarball） npm install https://github.com/Julzk/whatsapp-web.js/tarball/jkr_hotfix_7
? 提示：安装后可通过 npm list whatsapp-web.js 确认版本是否为 1.24.0-jkr-hotfix-7 或类似标识。该分支已向主仓库提交 PR，但尚未合并进 npmjs.org 官方发布版。
dmap-jsapi-skill下载DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
? 额外注意事项：
- 确保 Puppeteer 启动参数兼容性（尤其在 Docker 或无头服务器环境），建议显式启用 --no-sandbox 和 --disable-setuid-sandbox；
- 避免在 qr 回调中调用 client.destroy() 或重复 initialize()，否则可能中断状态机；
- 若仍不触发 ready，可临时添加调试钩子验证登录状态：
client.on('authenticated', () => console.log('Authenticated')); client.on('change_state', state => console.log('State:', state)); // 如 'CONNECTED', 'TIMEOUT'
? 总结：ready 事件失效是 SDK 版本级 Bug，非配置或逻辑错误。采用经过验证的修复分支是最高效、低风险的解决方案。待官方发布新版（≥1.24.0 正式版）后，建议及时回归标准 npm 安装方式，并关注 whatsapp-web.js Release Notes 获取更新提示。
