使用ipfs-http-client上传NFT元数据触发Connection timeout报错求助

核心原因 #

Connection timeout报错是客户端无法成功连接Infura公共IPFS节点的5001端口导致的，同时你的代码存在基础语法错误，也会影响后续执行。

修复步骤 #

• 第一步：修复对象语法错误
  tokenObject中的name、description属性为字符串类型，缺少引号包裹，修改后代码如下：

  const tokenObject = {
    name: "Epic NFT token",
    image: "https://ipfs.io/ipfs/QmexGL2pVe8dVkmm3soPXBMajvFkjFfjasoxwG2G9fTnR2",
    description: "This is NFT token"
  }
  

• 第二步：补全Infura节点鉴权配置
  Infura公共IPFS节点早已停止无鉴权访问，你需要注册Infura账号创建IPFS项目，获取项目ID和项目密钥，在初始化IPFS客户端时添加鉴权头：

  const ipfsClient = require("ipfs-http-client");
  // 替换为你自己的Infura IPFS项目信息
  const projectId = "你的项目ID";
  const projectSecret = "你的项目密钥";
  const auth = 'Basic ' + Buffer.from(projectId + ':' + projectSecret).toString('base64');
  
  const ipfs = ipfsClient({
    host: "ipfs.infura.io",
    port: 5001,
    protocol: "https",
    headers: {
      authorization: auth
    }
  });
  
  // 上传成功后可通过cid.path获取哈希值
  const cid = await ipfs.add(JSON.stringify(tokenObject));
  console.log("上传成功，CID为：", cid.path);
  

• 第三步：网络问题排查
  若添加鉴权后仍出现超时，优先检查当前网络是否能正常访问Infura服务，国内环境建议配置代理，或替换为其他支持无鉴权/易访问的IPFS服务，也可以本地安装IPFS节点直接调用本地端口测试，规避公网连接问题。
• 第四步：依赖版本校验
  若仍调用失败，检查ipfs-http-client版本是否为最新稳定版，旧版本的API调用规则和返回结构存在差异，可能导致异常。

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