网络闲置15-20分钟后调用sendTransaction失败问题求助

这个问题我在GCP部署Fabric网络时也碰到过，核心原因是GCP TCP负载均衡/防火墙的默认15分钟空闲连接超时规则——旧版Fabric Node SDK的gRPC客户端默认没启用连接保活机制，闲置后连接会被GCP主动断开，第一次调用复用失效连接就会失败，第二次调用会重建新连接所以能成功。

下面是两种可以结合使用的有效解决方法：

1. 配置gRPC Keepalive参数保持连接活跃 #

通过设置gRPC的保活参数，让客户端定期发送ping包，避免连接因闲置被GCP断开。在初始化Fabric客户端前添加以下配置：

const grpc = require('grpc');
const fabricClient = require('fabric-client');

// 配置gRPC保活参数，间隔必须小于GCP的15分钟超时
const grpcKeepaliveOpts = {
  'grpc.keepalive_time_ms': 30000, // 每30秒发送一次保活ping
  'grpc.keepalive_timeout_ms': 10000, // ping响应超时时间（10秒）
  'grpc.keepalive_permit_without_calls': true, // 即使无业务调用也发送ping
  'grpc.http2.max_pings_without_data': 0, // 取消无数据时的ping次数限制
  'grpc.http2.min_time_between_pings_ms': 5000 // 最小ping间隔（5秒）
};

// 将配置应用到Fabric客户端的默认gRPC选项
fabricClient.setConfigSetting('grpc.default_options', grpcKeepaliveOpts);

这个配置会让gRPC客户端每隔30秒向Orderer发送ping包，维持连接活跃状态，不会触发GCP的空闲超时规则。

2. 添加调用重试逻辑处理失效连接 #

即便配置了keepalive，也可能存在极端情况导致连接失效，所以在链码调用处添加重试逻辑，捕获SERVICE_UNAVAILABLE或UNAVAILABLE类错误后自动重试一次：

async function invokeChaincode(channel, chaincodeId, functionName, args) {
  const maxRetries = 1; // 设置重试次数
  let attempt = 0;

  while (attempt <= maxRetries) {
    const txId = fabricClient.newTransactionID();
    const request = {
      chaincodeId: chaincodeId,
      fcn: functionName,
      args: args,
      txId: txId
    };

    try {
      // 发送交易提案
      const proposalResponses = await channel.sendTransactionProposal(request);
      // 发送交易到Orderer
      const sendTxResponse = await channel.sendTransaction({
        proposalResponses: proposalResponses[0],
        proposal: proposalResponses[1]
      });
      
      if (sendTxResponse.status === 'SUCCESS') {
        return sendTxResponse;
      } else {
        throw new Error(`Transaction failed with status: ${sendTxResponse.status}`);
      }
    } catch (error) {
      attempt++;
      // 判断是否为连接失效类错误
      const isConnError = error.message.includes('SERVICE_UNAVAILABLE') || 
                          error.message.includes('UNAVAILABLE') ||
                          error.message.includes('TCP Read failed');
      
      if (!isConnError || attempt > maxRetries) {
        // 非连接错误或超出重试次数，抛出原错误
        throw error;
      }
      
      console.warn(`Attempt ${attempt - 1} failed due to connection issue, retrying...`);
      // 重试前短暂等待，给客户端重建连接的时间
      await new Promise(resolve => setTimeout(resolve, 2000));
    }
  }
}

额外检查点 #

• 确认你的Fabric Node SDK版本在v1.4及以上，旧版本对gRPC keepalive的支持可能不完善；
• 如果Orderer前端使用了GCP HTTP(S)负载均衡，要确保配置支持HTTP/2（gRPC基于HTTP/2），也可以适当调整空闲超时，但优先用keepalive方案更可靠。

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