AWS SDK for JavaScript S3客户端：Buffer/字符串无法赋值给StreamingBlobTypes

问题根源 #

AWS SDK for JavaScript v3里，PutObjectCommand的Body参数要求的StreamingBlobTypes类型，在Node.js环境下对应的是Uint8Array、ReadableStream这类类型。Node.js原生的Buffer或者普通字符串并不直接匹配这个类型定义，所以TypeScript在构建阶段会抛出类型不兼容的错误。

具体解决方法 #

1. Node.js Buffer转Uint8Array #

Buffer本身就是Uint8Array的子类，直接转换即可：

import { PutObjectCommand, S3Client } from "@aws-sdk/client-s3";
import fs from "fs";

const s3Client = new S3Client({ region: "你的区域" });

// 读取文件得到Buffer后转成Uint8Array
const fileBuffer = fs.readFileSync("./test.txt");
const uploadBody = Uint8Array.from(fileBuffer);

const uploadCommand = new PutObjectCommand({
  Bucket: "你的存储桶名称",
  Key: "test.txt",
  Body: uploadBody, // 类型匹配
});

await s3Client.send(uploadCommand);

嫌麻烦也可以直接用类型断言（前提是确认Buffer的兼容性）：

Body: fileBuffer as Uint8Array

2. 字符串转Uint8Array #

如果要上传字符串内容，用TextEncoder编码成Uint8Array即可：

const content = "这是要上传的文本内容";
const uploadBody = new TextEncoder().encode(content);

const uploadCommand = new PutObjectCommand({
  Bucket: "你的存储桶名称",
  Key: "text-content.txt",
  Body: uploadBody,
});

3. 大文件用ReadableStream（推荐） #

如果处理大文件，直接用Node.js的可读流，完全符合StreamingBlobTypes类型要求：

const fileStream = fs.createReadStream("./large-file.mp4");

const uploadCommand = new PutObjectCommand({
  Bucket: "你的存储桶名称",
  Key: "large-file.mp4",
  Body: fileStream,
});

补充说明 #

• 浏览器环境下，StreamingBlobTypes包含Blob，可以直接把字符串转成Blob：new Blob([content])，Buffer在浏览器里直接用Uint8Array替代即可。
• 尽量别用as any这种粗暴的类型断言，优先用类型兼容的转换方式，保证代码的类型安全。

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