Hedera私有Topic消息发送失败：gRPC超时问题求助

问题描述 #

我是区块链新手，按照Hedera官方文档编写代码尝试向私有Topic发送消息，已创建测试网账户且.env配置正确，但执行TopicCreateTransaction.execute时触发超时错误，重试10次后失败，错误为GrpcServiceError: gRPC service failed with status: TIMEOUT。

错误日志 #

[Running] node "/Users/cl/Documents/VSCODE/Blockchain_HCS/hello-hedera-js-sdk/query_ledger.js"
/Users/cl/Documents/VSCODE/Blockchain_HCS/hello-hedera-js-sdk/node_modules/@hashgraph/sdk/lib/Executable.cjs:675
    throw new Error(`max attempts of ${maxAttempts.toString()} was reached for request with last error being: ${persistentError != null ? persistentError.toString() : ""}`);
          ^

Error: max attempts of 10 was reached for request with last error being: GrpcServiceError: gRPC service failed with status: TIMEOUT
    at TopicCreateTransaction.execute (/Users/cl/Documents/VSCODE/Blockchain_HCS/hello-hedera-js-sdk/node_modules/@hashgraph/sdk/lib/Executable.cjs:675:11)
    at async submitFirstMessage (/Users/cl/Documents/VSCODE/Blockchain_HCS/hello-hedera-js-sdk/query_ledger.js:24:20)

Node.js v21.7.1

[Done] exited with code=1 in 100.343 seconds

使用代码 #

console.clear();
require("dotenv").config();
const {
  AccountId,
  PrivateKey,
  Client,
  TopicCreateTransaction,
  TopicMessageQuery,
  TopicMessageSubmitTransaction,
} = require("@hashgraph/sdk");

// Grab the OPERATOR_ID and OPERATOR_KEY from the .env file
const myAccountId = process.env.MY_ACCOUNT_ID;
const myPrivateKey = process.env.MY_PRIVATE_KEY;

// Build Hedera testnet and mirror node client
const client = Client.forTestnet();

// Set the operator account ID and operator private key
client.setOperator(myAccountId, myPrivateKey);

async function submitFirstMessage() {
  // Create a new topic
  let txResponse = await new TopicCreateTransaction().execute(client);

  // Grab the newly generated topic ID
  let receipt = await txResponse.getReceipt(client);
  let topicId = receipt.topicId;
  console.log(`Your topic ID is: ${topicId}`);

  // Wait 5 seconds between consensus topic creation and subscription creation
  await new Promise((resolve) => setTimeout(resolve, 5000));

  // Create the topic
  new TopicMessageQuery()
    .setTopicId(topicId)
    .subscribe(client, null, (message) => {
      let messageAsString = Buffer.from(message.contents, "utf8").toString();
      console.log(
        `${message.consensusTimestamp.toDate()} Received: ${messageAsString}`
      );
    });

  // Send message to topic
  let sendResponse = await new TopicMessageSubmitTransaction({
    topicId: topicId,
    message: "Hello, HCS!",
  }).execute(client);
  const getReceipt = await sendResponse.getReceipt(client);

  // Get the status of the transaction
  const transactionStatus = getReceipt.status;
  console.log("The message transaction status: " + transactionStatus.toString());
}

submitFirstMessage();

排查步骤与解决方案 #

1. 检查网络连接与防火墙限制 #

• 确认本地网络可正常访问Hedera测试网节点，gRPC默认使用443端口，检查防火墙是否允许出站到测试网节点IP的443端口。
• 尝试切换网络（如手机热点），排除内网环境限制。

2. 调整客户端超时与重试参数 #

手动修改SDK默认参数，适配网络环境：

// 在创建client后添加配置
client.setRequestTimeout(60000); // 将请求超时设为60秒
client.setMaxAttempts(5); // 减少重试次数，避免长时间等待

3. 验证账户状态与余额 #

• 确保测试网账户有足够HBAR余额（创建Topic需约0.01 HBAR手续费），可通过Hedera浏览器查询账户状态。
• 确认账户未被冻结或处于异常状态。

4. 指定特定测试网节点 #

替换默认节点选择逻辑，手动指定节点：

const client = Client.forTestnet();
// 手动设置测试网节点
client.setNetwork({
  "0.testnet.hedera.com:50211": "0.0.3",
  "1.testnet.hedera.com:50211": "0.0.4",
  "2.testnet.hedera.com:50211": "0.0.5"
});

5. 降级Node.js版本 #

当前使用的Node.js v21.7.1较新，可能存在SDK兼容性问题，尝试降级到LTS版本（如v18.x或v20.x）。

6. 更新SDK版本 #

确保使用最新稳定版@hashgraph/sdk，执行命令更新：

npm update @hashgraph/sdk

内容的提问来源于stack exchange，提问作者Clément