使用Node.js SDK调用链码报错：Cannot read property 'getConnectivityState' of undefined

我之前在基于Hyperledger Fabric开发Node.js应用时遇到过一模一样的错误，这个问题的核心是EventHub的连接状态管理出了问题，下面是我总结的排查和解决思路：

首先看报错的核心堆栈：

Failed to invoke successfully :: TypeError: Cannot read property 'getConnectivityState' of undefined
/opt/share/hyperledger/node_modules/fabric-client/lib/EventHub.js:355
if(self._stream) state = self._stream.call.channel.getConnectivityState();
^
TypeError: Cannot read property 'getConnectivityState' of undefined
at ClientDuplexStream. (/opt/share/hyperledger/node_modules/fabric-client/lib/EventHub.js:355:56)

这说明SDK内部的EventHub对象中，_stream.call.channel这个属性未定义，导致调用getConnectivityState()方法时抛出类型错误，本质是EventHub没有正确建立或维护与Peer节点的连接。

1. 校验EventHub的初始化与连接流程 #

这个错误最常见的原因是EventHub未正确连接就执行了链码调用：

• 确保在调用链码之前，已经调用eventHub.connect()并等待连接成功的回调/Promise完成
• 不要在链码调用过程中误触发eventHub.disconnect()，提前销毁连接
• 检查Peer节点的事件端口（默认是7053）是否对外开放，SDK配置的Peer地址格式是否正确（比如grpc://peer0.org1.example.com:7053）

2. 升级Fabric Node.js SDK到兼容版本 #

这个bug在fabric-client的旧版本（比如v1.4.x早期版本）中比较普遍，是SDK内部的状态管理漏洞：

• 如果你的Fabric集群是v1.4.x，建议升级到稳定的v1.4.12版本
• 如果是v2.x集群，直接使用最新的fabric-network SDK（替代旧的fabric-client）
• 执行命令指定版本安装：

npm install fabric-client@1.4.12 --save

3. 增加EventHub的状态检查逻辑 #

如果暂时无法升级SDK，可以在代码中手动增加连接状态的校验，避免触发内部错误：

// 示例：封装安全的链码调用前检查
const eventHub = client.newEventHub();
eventHub.setPeerAddr(peerEventAddr);

// 确保EventHub连接成功后再执行调用
eventHub.connect({ signed: true }, (err) => {
  if (err) {
    console.error('EventHub连接失败：', err);
    return;
  }
  // 执行链码调用前再次检查连接状态
  if (!eventHub._stream?.call?.channel) {
    console.warn('EventHub连接状态异常，重新连接');
    eventHub.disconnect();
    eventHub.connect({ signed: true }, () => invokeChainCode());
    return;
  }
  invokeChainCode();
});

function invokeChainCode() {
  // 你的链码调用逻辑
}

4. 检查Peer节点的运行状态 #

如果Peer节点本身故障或网络异常，也会导致EventHub连接异常：

• 执行peer node status命令检查Peer是否正常运行
• 查看Peer节点日志（默认路径/var/log/hyperledger/fabric/peer.log），排查是否有连接相关的错误日志

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