Hyperledger Fabric 2.2：离线Peer导致组织无法连接网络的解决方法

嗨，我之前也碰到过一模一样的问题！核心原因是Fabric Gateway的服务发现默认会尝试连接组织配置里的所有Peer节点，只要有一个连不上就触发超时错误，不会自动跳过不可用节点。下面给你几个可行的解决方案：

1. 配置Gateway的Peer选择策略（最推荐） #

修改你的Gateway连接配置，添加discovery.config.peerSelection参数，让客户端自动筛选可用的Peer：

const gatewayOpts = {
  wallet: this.wallet,
  identity: username,
  discovery: {
    enabled: true,
    asLocalhost: false,
    config: {
      peerSelection: {
        strategy: 'PreferOrg', // 优先选择当前组织的Peer
        options: {
          priority: [{'mspid': 'org1'}], // 指定优先选择org1的节点
          timeout: 3000, // 单个节点连接超时时间（毫秒）
          maxAttempts: 2 // 尝试连接不同节点的最大次数
        }
      }
    }
  }
} as GatewayOptions;

这个配置会让客户端在发现阶段，优先尝试连接本组织的Peer，当某个节点连接超时后，自动切换到下一个可用的节点，不会因为单个Peer离线而抛出错误。

2. 开启gRPC连接重试机制 #

在Gateway配置中添加gRPC的重试参数，让客户端在连接失败时自动重试其他节点：

const gatewayOpts = {
  wallet: this.wallet,
  identity: username,
  discovery: {
    enabled: true,
    asLocalhost: false
  },
  grpcOptions: {
    'grpc.enable_retries': true, // 开启重试
    'grpc.max_retry_attempts': 2, // 最大重试次数
    'grpc.retry_delay_ms': 1000, // 重试间隔
    'grpc.keepalive_time_ms': 30000, // 保持连接的心跳间隔
    'grpc.max_receive_message_length': -1, // 取消消息长度限制（可选）
    'grpc.max_send_message_length': -1
  }
} as GatewayOptions;

这个配置从底层gRPC层面增加了容错性，当第一次连接离线Peer失败后，会自动重试连接组织内的其他可用Peer。

3. 额外注意事项 #

• 确保你的Node.js Fabric SDK版本是v2.2.x系列的稳定版本，老版本可能不支持上述peerSelection配置。
• 不需要手动从组织的Peer列表中移除离线节点，保持完整的列表才能让客户端有更多可用节点选择。
• 测试时可以反复启停peer2-org1，验证应用是否能自动切换到peer1-org1，确保容错逻辑生效。

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