NodeJS使用WebSocket监听智能合约事件报connection not open on send()错误

错误核心原因：调用send()发送订阅请求时，WebSocket连接尚未完成握手建立，属于典型的时序/连接可用性问题，和智能合约本身逻辑无关

• 修正连接时序逻辑
  绝大多数报错都是实例化客户端后立刻发起订阅导致的。不要在创建WS Provider之后直接调用合约事件订阅方法，必须等连接的connect事件触发后，再执行订阅操作。
  参考正确写法（web3.js为例）：

  const Web3 = require('web3');
  // 替换为自己的节点WS地址
  const wsProvider = new Web3.providers.WebsocketProvider('wss://your-node-ws-endpoint');
  
  // 连接建立成功后再初始化合约、发起订阅
  wsProvider.on('connect', () => {
    const web3 = new Web3(wsProvider);
    const contract = new web3.eth.Contract(contractAbi, contractAddress);
    // 事件监听逻辑放在连接成功回调内
    contract.events.Transfer({ fromBlock: 'latest' })
      .on('data', event => console.log('收到事件:', event.returnValues))
      .on('error', err => console.error('订阅异常:', err));
  });
  
  // 必须加连接异常、断开监听，方便定位问题
  wsProvider.on('error', err => console.error('WS连接错误:', err.message));
  wsProvider.on('end', () => console.log('WS连接已断开'));
  

  不要用固定时长的setTimeout延迟执行订阅，网络波动场景下固定延迟无法保证连接就绪，必须以connect事件作为连接可用的判断依据。

• 排查节点WS服务连通性
  先排除基础连接问题再写业务逻辑：

  1. 确认使用的是wss:///ws://开头的websocket端点，不要把HTTP/HTTPS的RPC地址填到WS Provider配置里
  2. 本地先装wscat工具测试节点连通性，执行npm install -g wscat && wscat -c 你的WS节点地址，如果工具都连不上，优先排查节点服务状态、本地网络出网限制、节点API鉴权参数是否正确
  3. 如果用第三方节点服务（Infura、Alchemy等），确认当前服务套餐没有超过WS连接数限制、IP没有被节点封禁

• 配置可靠的重连机制
  原生WS Provider默认重连逻辑不可靠，网络波动、节点超时导致连接断开后，重连过程中发起请求也会触发该错误。初始化Provider时加上重连配置：

  const wsProvider = new Web3.providers.WebsocketProvider('wss://your-node-ws-endpoint', {
    reconnect: {
      auto: true,
      delay: 5000, // 重连间隔5秒
      maxAttempts: 15,
      onTimeout: true
    }
  });
  

  注意监听重连成功事件，重新触发订阅逻辑，不要在连接断开状态下持续调用请求方法。

• 排查依赖版本兼容问题
  web3.js 1.7.0及之前的早期版本存在已知的WS连接时序bug，会在连接未就绪时内部自动发送请求触发报错，直接升级到1.8.0以上的稳定版本即可修复；如果问题仍存在，可以切换到ethers.js实现同类功能，避开版本坑。

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