Node.js调用Stripe API无法访问文件/图片，返回URL与文档不符

你遇到的核心问题是：通过files.retrieve获取到的File对象中的url是Stripe内部API端点，需要携带API密钥才能访问，不能直接在浏览器或前端使用。而你看到的可直接访问的URL属于File Link资源，需要单独获取或创建。

现有解决方案：提取已存在的File Link #

你的响应中links.data数组里已经包含了一个File Link对象，只是没有展开。直接取出它的url即可：

const file = await generalConfig.stripe.files.retrieve(req.session.user.data.logo, { stripeAccount: 'connected-account-id' });
// 提取第一个File Link的公开访问URL
const publicLogoUrl = file.links.data[0].url;

备用方案：手动创建File Link #

如果links.data为空，或者需要生成新的访问链接，可以调用Stripe的File Links创建接口：

const fileLink = await generalConfig.stripe.fileLinks.create(
  { file: req.session.user.data.logo },
  { stripeAccount: 'connected-account-id' }
);
const publicLogoUrl = fileLink.url;

关键说明 #

• Stripe的File对象本身的url字段是API私有端点，仅能通过后端携带密钥请求，不能直接暴露给前端。
• File Link是Stripe生成的临时/永久公开链接，专门用于前端展示或用户下载，无需额外身份验证。
• 对于purpose: 'business_logo'的文件，Stripe默认会自动生成对应的File Link，所以大部分情况下直接提取即可。

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