Node.js+TypeScript中如何将S3图片转为Sharp支持的输入格式

核心结论 #

在基于TypeScript的Node.js后端场景下，aws-sdk v2 getObject 返回的response.Body在运行时实际为Buffer类型，该类型是Sharp原生支持的入参，直接做类型断言即可使用，无额外转换开销，是最优选择。

文档标注的Readable | ReadableStream | Blob是跨运行时的通用类型定义，纯Node.js环境下默认不会返回这三类对象。Buffer本身是Uint8Array的子类，完全覆盖Sharp支持的入参类型范围。

正确实现代码 #

const getRequest: S3.GetObjectRequest = {
    Bucket: config.aws.bucketName,
    Key: uuid
};
  
const response = await s3client.getObject(getRequest).promise();
// 直接断言为Buffer即可，无运行时风险
const imageBuffer = response.Body as Buffer;

// 直接传入Sharp完成旋转等处理
const rotatedImage = await sharp(imageBuffer)
  // 不传参时rotate会自动读取图片EXIF信息修正方向，也可传入数字指定旋转角度
  .rotate()
  .toBuffer();

注意事项 #

• 无需额外将响应体转为流、Uint8Array等格式，直接使用返回的Buffer性能最高，没有额外序列化/流读取开销
• 仅当你在非Node.js运行时（如浏览器、Edge Runtime）调用S3接口拿到Blob/ReadableStream类型的Body时，才需要手动做格式转换，Node.js后端场景不需要该操作
• 只要你没有手动修改S3客户端的响应数据类型配置，该类型断言不存在运行时错误风险

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