在使用 whatsapp-web-js 时，必须确保 client 实例完成初始化（即调用 client.initialize() 并等待其 Promise 解析）后，再注册 'qr'、'ready' 等事件监听器，否则会因 client 尚未就绪而触发 TypeError 或空引用错误。

在使用 whatsapp-web-js 时，必须确保 `client` 实例完成初始化（即调用 `client.initialize()` 并等待其 promise 解析）后，再注册 `'qr'`、`'ready'` 等事件监听器，否则会因 `client` 尚未就绪而触发 `typeerror` 或空引用错误。

Node.js 是单线程异步运行环境，代码执行不阻塞但也不保证时序——这意味着若在 client 实例创建后立即调用 .on() 绑定事件，而此时 client.initialize() 尚未完成（甚至尚未开始），client 内部状态仍为未就绪，事件系统可能尚未激活，从而导致监听器注册失败或静默忽略。

正确做法是：所有 .on() 事件监听器必须在 client.initialize() 的 Promise 成功解析（即 .then() 回调内）之后注册。这确保了 client 已完成内部初始化、事件发射器已就绪、且上下文完全可用。

以下是重构后的可靠初始化流程：

WhatsApp 428 修复

修复 WhatsApp Web 的 428 错误及代理配置问题，适用于连接断开（状态428）、需要配置代理或在新机器部署 OpenClaw 后出现的 WhatsApp 连接故障。

下载

const { Client } = require('whatsapp-web.js');
const { RemoteAuth } = require('whatsapp-web.js/auth');
const { MongoStore } = require('whatsapp-web.js/mongo-store');
const mongoose = require('mongoose');
const qrcode = require('qrcode-terminal');

let client;

// 连接 MongoDB 并初始化客户端
mongoose.connect('mongodb+srv://...url')
  .then(() => {
    console.log('✅ MongoDB connected');

    const store = new MongoStore({ mongoose });
    client = new Client({
      authStrategy: new RemoteAuth({
        store,
        backupSyncIntervalMs: 60000
      })
    });

    // 关键：仅在 initialize() 完成后注册所有事件监听器
    return client.initialize();
  })
  .then(() => {
    console.log('✅ WhatsApp client initialized');

    // ✅ 此时 client 已就绪，可安全绑定事件
    client.on('qr', (qr) => {
      console.log('? QR code generated — scan to authenticate');
      qrcode.generate(qr, { small: true });
    });

    client.on('remote_session_saved', () => {
      console.log('? Remote session saved to MongoDB');
    });

    client.on('ready', () => {
      console.log('? WhatsApp client is ready — start sending/receiving messages');
      // 此处可安全调用 client.sendMessage()、监听 message 事件等
    });

    client.on('disconnected', (reason) => {
      console.warn('⚠️ Client disconnected:', reason);
      // 可在此触发自动重连逻辑（需配合重试策略）
    });
  })
  .catch((error) => {
    console.error('❌ Initialization failed:', error);
    process.exit(1);
  });

? 关键注意事项：

• ❌ 错误写法：client.on('ready', ...) 放在 client.initialize() 外部（如 .then() 之前或 mongoose.connect().then() 的顶层作用域），会导致监听器注册过早；
• ✅ 正确时机：所有 .on() 必须位于 client.initialize().then(...) 内部；
• ⚠️ client.initialize() 返回 Promise，不可省略 .then() 或 await；若使用 async/await，需确保所在函数为 async 并正确 await client.initialize()；
• ? 建议统一使用 .catch() 或 try/catch 捕获初始化异常，避免未处理 Promise rejection 导致进程意外退出；
• ? 若需支持断线重连，应在 'disconnected' 事件中设计退避重试机制，而非依赖 client.initialize() 被多次调用（注意：initialize() 不可重复调用，应重建实例）。

遵循该模式，即可彻底规避 “Cannot call .on() before client initialization” 类型的运行时错误，构建稳定可靠的 WhatsApp 自动化服务。