从Google Cloud Storage流式下载图片时如何正确设置响应头并获取文件大小

看起来你在处理从Google Cloud Storage（GCS）提供图片下载的场景，需要在download=true时设置Content-Length响应头。下面给你几种可行的方案，按推荐程度排序：

方案1：直接从GCS文件元数据获取（推荐） #

GCS的文件对象本身带有元数据，其中包含准确的文件大小信息。你可以通过getMetadata()方法异步获取，这是最省心且数据精准的方式，无需额外维护外部存储。

修改你的代码如下：

app.get('/:image/:size.:ext', async (req, res) => { 
  const remote = bucket.file(`${req.params.image}/${req.params.size}.${req.params.ext}`);

  if (req.query.download == 'true') { 
    try {
      // 获取文件元数据，从中提取大小
      const [metadata] = await remote.getMetadata();
      const fileSize = metadata.size;

      res.set('Content-Type', 'image/jpg');
      res.set('Content-Disposition', `attachment; filename="${req.params.image}.${req.params.size}.${req.params.ext}";`);
      res.set('Content-Transfer-Encoding', 'binary');
      res.set('Content-Length', fileSize); // 设置内容长度头
    } catch (err) {
      console.error('获取文件元数据失败:', err);
      // 错误兜底，返回占位图
      res.send(`data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7`);
      return;
    }
  } 

  // if (isProd) 
  // res.set('Cache-Control', 'public, max-age=604800');

  remote.createReadStream({ validation: false }) 
    .on('error', error => { 
      console.log(error);
      res.send(`data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7`);
    }) 
    .pipe(res);
})

注意要把路由处理函数改成async，因为getMetadata()是异步操作。

方案2：预存文件大小到数据库 #

如果你的应用需要频繁获取文件大小，或者想减少GCS的API调用次数，可以在文件上传到GCS时，把文件大小、路径等信息同步存入数据库（比如MongoDB、PostgreSQL）。

使用时直接从数据库查询对应记录即可：

// 假设你有一个封装好的数据库查询函数
const fileSize = await getImageSize(req.params.image, req.params.size, req.params.ext);
if (fileSize) {
  res.set('Content-Length', fileSize);
}

这种方式响应更快，但需要确保数据库数据与GCS文件一致——比如在文件更新、删除时同步更新数据库记录，否则会出现大小不匹配的问题。

方案3：通过流获取大小（不推荐） #

你也可以先把流的全部数据读取到内存或临时文件，计算总大小后再发送给客户端。但这种方式会显著增加内存占用和响应延迟，尤其是处理大文件时，可能引发性能瓶颈，所以不推荐使用。

总结 #

优先选择方案1，它无需额外维护，数据准确；如果性能要求极高且文件更新频率低，可以考虑方案2；方案3尽量避免。

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