Hyperledger Fabric Node SDK 1.4 注销合约监听器后程序不终止

场景说明 #

• 基于Hyperledger Fabric Node SDK 1.4版本开展业务开发，需求是创建合约事件监听器，在捕获到匹配的指定事件消息后，自动关闭当前运行的程序
• 开发过程中按照官方事件监听的标准流程实现逻辑，但调用监听器注销操作后，程序始终处于挂起运行状态没有自动退出，查阅对应版本的官方事件监听开发文档，也没有找到其他停止事件监听的实现路径

已实现的核心逻辑 #

const contract = await fabricService.getContract(user, contractName);

const listener = await contract.addContractListener(
    'tests',
    'contract',
    (_error: Error, event: any, _blockNumber?: string, _transactionId?: string, _status?: string) => {
      console.log('message received');
      const data = (event.payload as Buffer).toString('utf8');
      expect(data).to.equal('xxxx');
      listener.unregister();
    }
);

listener.unregister();

预期与实际运行差异 #

• 预期：完成监听器注销操作后，没有活跃异步任务支撑事件循环，Node.js进程会自动回收退出
• 实际：执行完所有unregister逻辑后，程序持续挂起，完全没有终止迹象

核心原因与修正要点 #

• unregister()方法的作用范围非常有限：它仅负责解除当前监听器和对应事件的绑定关系，让监听器不再响应匹配的合约事件，并不会主动关闭SDK初始化阶段建立的所有底层网络连接
• Node.js进程的退出机制要求：只要事件循环中还存在未释放的活跃句柄（比如gRPC长连接、打开的文件流、定时任务），进程就不会自动退出。SDK 1.4版本在初始化网关、通道、合约实例的过程中，会和各类Fabric节点建立持久化的gRPC事件推送连接，这些连接的生命周期不受单个监听器注销操作的影响
• 要实现监听器注销后程序正常退出，除了注销监听器之外，还需要补充完成资源释放操作，常见遗漏点包括：
  • 主动调用已初始化网关实例的disconnect()方法，关闭网关上挂载的所有节点连接，释放底层gRPC通道
  • 排查是否存在其他未注销的监听器（区块监听、交易事件监听等），这类监听器同样会持有活跃的事件推送连接
  • 等所有连接的关闭流程完全完成后，再触发进程退出
• 现有代码存在的逻辑问题：代码在创建完监听器的同步流程里直接调用了一次listener.unregister()，这会导致监听器还没来得及接收到任何事件就被提前注销，完全失去监听能力，需要删除这行冗余的提前注销逻辑

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