Solana空投请求失败求助：触发速率限制及内部错误

问题重现 #

尝试以下CLI命令请求Solana Devnet空投：

solana airdrop 1
solana airdrop 1 <address> --url devnet
solana airdrop 1 <address> --url https://api.devnet.solana.com

所有命令均返回错误：

Error: airdrop request failed. This can happen when the rate limit is reached.

同时，使用@solana/web3.js的TypeScript函数airdropSol()也失败，错误信息：

Error: airdrop to GFfY2JVH2iB9gRmg7oKdwgGJcbXuhGu8vEsMY5yJryeq failed: Internal error
at Connection.requestAirdrop (/home/user/hellow_world/node_modules/@solana/web3.js/src/connection.ts:3905:13)
at processTicksAndRejections (internal/process/task_queues.js:95:5)

解决方法 #

• 切换备用Devnet节点
  官方默认节点https://api.devnet.solana.com常因拥堵触发限速或内部错误，改用其他公开Devnet节点：
  CLI命令示例：

  solana airdrop 1 <address> --url https://devnet.solana.gateway.fm
  solana airdrop 1 <address> --url https://api.devnet.solana.com.cn
  

  TypeScript代码中修改连接配置：

  import { Connection, PublicKey } from "@solana/web3.js";
  
  const connection = new Connection("https://devnet.solana.gateway.fm", "confirmed");
  await connection.requestAirdrop(
    new PublicKey("GFfY2JVH2iB9gRmg7oKdwgGJcbXuhGu8vEsMY5yJryeq"),
    1 * 10**9 // 1 SOL（单位为lamports）
  );
  

• 等待限速重置
  官方节点对单个地址的空投请求有频率限制，通常为24小时内最多2次，单次最高2 SOL。若触发限速，等待限制周期结束后再尝试。

• 验证目标地址有效性
  确认空投目标地址为合法的Solana地址，避免格式错误导致的隐性失败：

  # 验证本地密钥对对应的地址
  solana address -k <your-keypath>
  # 直接验证地址格式
  solana validate-address <target-address>
  

• 添加重试逻辑
  Devnet节点偶尔会出现临时内部错误，通过重试可解决这类问题。TypeScript示例：

  async function retryAirdrop(
    connection: Connection,
    address: PublicKey,
    amount: number,
    maxRetries: number = 3
  ) {
    for (let i = 0; i < maxRetries; i++) {
      try {
        return await connection.requestAirdrop(address, amount);
      } catch (err) {
        if (i === maxRetries - 1) throw err;
        await new Promise(resolve => setTimeout(resolve, 2000)); // 间隔2秒重试
      }
    }
  }
  

• 使用网页端水龙头
  若CLI和代码请求均失败，可通过Solana官方Devnet网页端水龙头手动提交地址请求空投，部分网页端的限制会比API接口宽松。

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