问题描述
使用浏览器通过OSS默认域名访问文件时,可能会出现无法预览而是直接下载的现象。
问题原因
自2025年11月04日10:00起,在以下指定地域创建的Bucket,使用OSS默认域名访问特定类型文件时,OSS会在返回头中增加两个Header:
受影响的地域包括:
华东6(福州-本地地域-关停中)
华北6(乌兰察布)
华南2(河源)
华南3(广州)
华东5(南京-本地地域-关停中)
华中1(武汉-本地地域)
当访问以下MIME类型的文件时会触发强制下载:
image/jpeg
image/gif
image/tiff
image/png
image/webp
image/svg+xml
image/bmp
image/x-ms-bmp
cmu-raster
image/exr
image/x-icon
image/heic
text/html
x-oss-force-download:true
Content-Disposition: attachment
标准浏览器看到Content-Disposition: attachment
时会弹出下载而不是预览。
问题示例
例如,您在华南3(广州)地域创建了一个Bucket,Bucket内包含名为test.jpg的文件。您通过浏览器使用OSS默认域名访问test.jpg时:
GET /test.jpg HTTP/1.1
由于test.jpg的MIME类型为image/jpeg,属于受影响的文件类型,OSS会在响应中增加Content-Disposition
和x-oss-force-download
两个Header。
HTTP/1.1 200 OK
Content-Disposition: attachment
x-oss-force-download: true
标准浏览器发现Content-Disposition: attachment
时,会出现下载而不是预览行为。
解决方案
如果您不希望OSS返回强制下载头,请通过自定义域名访问对象。更多信息,请参见绑定自定义域名。
该文章对您有帮助吗?