使用deno-s3-lite-client上传S3时Content-Type为空问题排查

文件能正常上传到S3存储桶，但Content-Type字段为空，导致文件无法直接打开。代码中已尝试在metadata里设置"Content-Type": fileData.type，但未生效。

排查与解决方案 #

1. 确认fileData.type的有效性 #

先检查console.log("Uploading file to S3:", fileData.type)的输出是否为合法MIME类型（比如image/png、application/pdf）。如果前端传入的File对象type为空，需手动从文件名后缀推断类型：

function getMimeTypeFromFileName(filename: string): string {
  const ext = filename.split('.').pop()?.toLowerCase();
  switch(ext) {
    case 'png': return 'image/png';
    case 'pdf': return 'application/pdf';
    case 'jpg': case 'jpeg': return 'image/jpeg';
    case 'docx': return 'application/vnd.openxmlformats-officedocument.wordprocessingml.document';
    // 按需补充其他类型
    default: return 'application/octet-stream';
  }
}

// 替换原代码中的contentType赋值
const contentType = fileData.type || getMimeTypeFromFileName(fileName);

2. 检查API参数结构是否正确 #

部分S3客户端会将Content-Type作为独立配置项，而非嵌套在metadata中。查看deno-s3-lite-client的类型定义，尝试将contentType单独传入options：

// 修改上传代码的options结构
await s3Client.putObject(filePath, fileArrayBuffer, { 
  contentType: contentType,
  metadata: {
    // 若有自定义元数据，放在这里（需带x-amz-meta-前缀）
  }
});

3. 尝试与官方示例一致的流式上传 #

你的代码使用Uint8Array直接上传，而官方示例采用ReadableStream。部分客户端对不同数据源的元数据处理逻辑存在差异，尝试将Uint8Array转为流上传：

// 将Uint8Array转为ReadableStream
const dataStream = ReadableStream.from([fileArrayBuffer]);

const metadata = { "Content-Type": contentType };
await s3Client.putObject(filePath, dataStream, { metadata });

4. 验证metadata键名格式 #

尝试将Content-Type改为小写的content-type，部分客户端对大小写敏感：

const metadata = { "content-type": contentType };

5. 升级库到最新版本 #

如果是库本身的bug，升级到最新版本可能解决问题：

deno cache -r https://deno.land/x/deno_s3_lite_client@latest/mod.ts

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