使用Spring Cloud Azure上传至Azure Blob时设置Content-Disposition头

可以在上传Blob的同时直接设置content-disposition属性，无需分两次请求。核心是使用BlobUploadOptions类，将文件流与HTTP头部配置整合后一次性提交，避免额外的API调用开销。

修改后的Kotlin代码 #

val blobClient = blobServiceClient.getBlobContainerClient(containerName).getBlobClient(blobPath)

if (blobClient.exists()) throw AzureStorageBlobAlreadyExistsException(blobPath)

try {
    // 配置HTTP头部，设置content-disposition
    val blobHttpHeaders = BlobHttpHeaders().apply {
        contentDisposition = "attachment; filename=\"test.jpg\""
        // 可按需添加其他头部，比如文件MIME类型
        // contentType = "image/jpeg"
    }
    // 封装上传配置选项
    val uploadOptions = BlobUploadOptions(file.inputStream()).apply {
        httpHeaders = blobHttpHeaders
    }
    // 一次性完成上传与属性设置
    blobClient.uploadWithResponse(uploadOptions, null, null)
} catch (e: Exception) {
    // 按需处理上传异常
}

关键说明 #

• 使用BlobUploadOptions可以将文件流、HTTP头部等配置打包，通过uploadWithResponse（或重载的upload方法）发起单次请求，彻底避免两次API调用的问题。
• 之前提前调用setHttpHeaders报404错误，是因为Blob尚未创建，Azure不允许对不存在的Blob设置头部属性；而上传后再调用setHttpHeaders会触发第二次独立请求，增加网络开销。
• content-disposition中的文件名建议用双引号包裹，避免特殊字符导致客户端解析异常。

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