Todos os produtos
Search
Central de documentação

Object Storage Service:0048-00000101

Última atualização: Jul 03, 2026

Descrição do problema

Ao acessar um objeto por um navegador usando um nome de domínio padrão do Object Storage Service (OSS), o sistema pode baixar o arquivo em vez de exibi-lo.

Causas

Esse comportamento afeta objetos em buckets criados após as 11h00 de 24 de setembro de 2019. Se você usar um nome de domínio do OSS para acessar um objeto cujo Content-Type corresponder a um dos valores abaixo, o OSS adicionará dois cabeçalhos à resposta.

image/jpeg
image/gif
image/tiff
image/png
image/webp
image/svg+xml
image/bmp
image/x-ms-bmp
image/x-cmu-raster
image/exr
image/x-icon
image/heic

O OSS inclui os seguintes cabeçalhos na resposta:

x-oss-force-download: true
Content-Disposition: attachment

Navegadores padrão iniciam o baixe automaticamente ao receberem o cabeçalho Content-Disposition: attachment, o que impede a visualização direta.

Exemplos do problema

Por exemplo, ao acessar via navegador um objeto chamado apple.jpeg com ContentType image/jpeg em um bucket criado após as 11h00 de 24 de setembro de 2019, usando o nome de domínio padrão do OSS, o serviço adiciona os dois cabeçalhos citados à resposta. Quando o navegador recebe o cabeçalho Content-Disposition: attachment, ele solicita o baixe do arquivo em vez de exibir uma pré-visualização.

GET /apple.jpeg HTTP/1.1
HTTP/1.1 200 OK
Content-Type: image/jpeg
Content-Disposition: attachment
x-oss-force-download: true

Content-Disposition: attachment

Solução

Para evitar que o OSS adicione cabeçalhos que forçam o baixe, acesse o objeto por um nome de domínio personalizado. Para mais informações, consulte Vincular um nome de domínio personalizado.