Pinata IPFS创建组后上传文件无法加入组的问题求助

问题根源 #

你当前使用的是Pinata旧版上传接口/pinning/pinFileToIPFS，而分组是通过v3 API创建的，旧接口并不支持直接通过group参数关联v3分组。同时，直接在FormData中追加group字段也不符合v3 API的参数规范——v3上传接口要求将分组ID放在pinataOptions的group_id字段中。

修复步骤 #

1. 切换到v3版本的文件上传接口 #

将上传接口地址从旧版的https://api.pinata.cloud/pinning/pinFileToIPFS替换为v3接口：
https://api.pinata.cloud/v3/files/public/upload

2. 调整FormData参数结构 #

移除单独的group字段，将分组ID放入pinataOptions的JSON字符串中，同时保留pinataMetadata和network参数。

修复后的上传函数 #

const uploadFileToPinata = async (filePath, fileName, groupID) => {
  try {
    const url = "https://api.pinata.cloud/v3/files/public/upload";
    const data = new FormData();

    data.append("file", fs.createReadStream(filePath), { filename: fileName });
    data.append("pinataMetadata", JSON.stringify({ name: fileName }));
    data.append("pinataOptions", JSON.stringify({ group_id: groupID }));
    data.append("network", "public");

    const response = await axios.post(url, data, {
      headers: {
        ...data.getHeaders(),
        Authorization: `Bearer ${PINATA_JWT}`,
      },
    });

    return response.data.data?.ipfs_hash || null;
  } catch (error) {
    console.error(`Error uploading file ${fileName} to Pinata:`, error.message);
    // 可打印完整响应信息排查细节
    // console.error(error.response.data);
    return null;
  }
};

验证 #

修复后重新上传文件，再调用https://api.pinata.cloud/v3/files/public?group=${groupID}查询，应该能看到分组内的文件列表。如果仍有问题，可以打印error.response.data查看Pinata返回的具体错误提示，进一步排查参数是否正确。

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