web3合约事件订阅触发两次、getPastEvents返回重复结果问题咨询

问题根因分析 #

• 首先排查测试代码的写法错误：你给出的第二行测试代码contract.getPastEvents("Event").then(console.log('a'))本身存在逻辑错误，console.log('a')会在调用getPastEvents时同步执行，而非异步请求结束后执行，你传给then的实际是console.log的返回值undefined，所以这行代码的执行结果不具备参考性，正确的异步写法应为contract.getPastEvents("Event").then(() => console.log('a'))。
• 事件订阅、getPastEvents第一行代码重复返回结果是web3.js的常见问题，核心原因有三类：
  1. RPC节点集群响应重复：多数公共RPC服务采用多节点负载均衡架构，同一个请求可能被多个节点返回响应，导致回调重复触发。
  2. web3.js版本bug：1.x系列的多个小版本存在事件重复回调的已知问题，默认配置下事件会在区块打包、以及达到指定确认数（默认是12个确认）时各触发一次。
  3. 代码重复初始化：业务逻辑中重复初始化web3实例、重复绑定同个事件的监听回调，也会导致重复执行。

修复方案 #

1. 新增事件去重逻辑 #

通过事件的唯一标识过滤重复回调，是兼容性最强的修复方案，用transactionHash+logIndex作为事件唯一key即可：

// 事件订阅去重示例
const processedEventKeys = new Set()
contract.events.EventName().on('data', async event => {
  const eventKey = `${event.transactionHash}-${event.logIndex}`
  // 已处理过的事件直接跳过
  if (processedEventKeys.has(eventKey)) return
  processedEventKeys.add(eventKey)
  // 你的业务逻辑
  console.log(event)
})

2. 调整web3配置 #

初始化合约时关闭确认数监听，避免同个事件多次触发：

const contract = new web3.eth.Contract(ABI, 合约地址, {
  confirmations: 0 // 关闭确认数校验，事件仅在区块打包时触发一次
})

3. 其他排查方向 #

• 升级web3.js到最新稳定版，修复版本自带bug
• 切换独立RPC节点，排除公共节点集群的重复响应问题

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