如何使用aws.s3 R包上传图片至S3并实现在浏览器直接显示

我之前在使用aws.s3包上传图片到S3时也踩过一模一样的坑，咱们来一步步解决这个问题：

正确的aws.s3::put_object()写法 #

先直接给你能生效的代码，后面再解释关键细节：

aws.s3::put_object(
  file = "/path/to/your/target-image.jpg",
  object = "display-image.jpg",  # 记得带上.jpg后缀！
  bucket = "your-bucket-name",
  show_progress = TRUE,
  opts = list(
    acl = "public-read",
    content_type = "image/jpeg"  # 重点：这里是下划线，不是横杠！
  )
)

核心问题解析 #

你之前的代码里把content_type写成了"content-type"（横杠分隔），这是导致设置不生效的关键！AWS S3的API参数采用下划线命名法，而非HTTP头里的横杠格式。这个小错误会让S3忽略你的Content-Type设置，依然使用默认的binary/octet-stream，浏览器识别到这个类型就会触发下载。

额外保障步骤 #

为了确保万无一失，你可以做这几件事：

• 确认对象名带扩展名：给object参数设置的文件名加上.jpg或.jpeg后缀，部分浏览器会结合文件名后缀和Content-Type判断文件处理方式，双保险更稳妥。
• 验证元数据是否生效：上传完成后，用下面的代码检查图片的Content-Type是否正确设置：

  # 检查上传后的元数据
  metadata <- aws.s3::head_object(
    object = "display-image.jpg",
    bucket = "your-bucket-name"
  )
  cat("当前Content-Type:", metadata$headers$`content-type`, "\n")
  

  如果输出是image/jpeg，说明设置成功了。
• 清除浏览器缓存：如果之前访问过这个URL，浏览器可能缓存了旧的Content-Type，用Ctrl+F5强制刷新或者无痕模式测试就能看到效果。

其他可能的排查点 #

如果以上都做了还是触发下载，那可能是这两个原因：

• 你的S3存储桶开启了静态网站托管，并且配置了自定义的下载头规则，需要检查桶的托管设置。
• 图片本身不是标准的JPEG格式，比如后缀是jpg但实际是PNG，这种情况要对应修改Content-Type为image/png。

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