Express.js流式读取S3文件后无法正常下载问题求助

你在处理S3文件下载时踩了个常见的小坑——对res.attachment()的用法理解有误，而且错误地把签名URL当作本地流来处理了。咱们一步步来把问题搞定：

问题根源拆解 #

• res.attachment()的参数应该是要保存的文件名（比如invoice.pdf），用来告诉浏览器"这是个要下载的文件，用这个名字存"，而不是传入S3的签名URL。
• 签名URL是一个远程HTTP地址，不是本地可读流，你不能直接把它传给res.attachment()或者直接pipe到响应对象里。

方案一：直接重定向到签名URL（最简单高效） #

既然已经拿到了有效的签名URL，最省事的方式就是让浏览器直接跳转到这个地址，S3会直接处理下载请求，性能和代码简洁度都拉满：

// 获取签名URL
const url = s3Service.getSignedUrl({ 
  Bucket: process.env.s3BucketName, 
  Key: `vault-files/${filePath}`, 
  Expires: 240 
});

// 重定向到签名URL，浏览器会自动触发下载
res.redirect(url);

方案二：从S3拉取文件流再pipe到响应（适合需要中间处理的场景） #

如果你的业务需要在下载前对文件做一些自定义处理（比如加水印、加密片段），可以先从S3获取文件流，再pipe到响应：

const AWS = require('aws-sdk');
const s3 = new AWS.S3();

// 1. 构建S3读取对象的参数
const params = {
  Bucket: process.env.s3BucketName,
  Key: `vault-files/${filePath}`
};

// 2. 从filePath里提取文件名，设置下载响应头
const fileName = filePath.split('/').pop();
res.attachment(fileName);

// 3. 从S3获取可读流，直接pipe到响应对象
s3.getObject(params).createReadStream().pipe(res);

关键细节说明 #

• res.attachment(fileName)会设置正确的Content-Disposition响应头，浏览器会用这个文件名保存下载的文件。
• s3.getObject(params).createReadStream()会创建一个从S3读取文件的流，pipe到res后，浏览器就能接收到真实的文件内容并触发下载。

原代码失效的原因 #

你原代码里的res.attachment(url)会把签名URL当作文件名，浏览器会尝试保存一个名字超长的URL字符串文件；而stream.pipe(res)本质是把响应对象自己pipe给自己，完全没有传递实际的文件内容，自然无法正常下载。

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