В этой ситуации браузер часто выполняет ровно то, что ему сообщили. Если ответ содержит `Content-Disposition: attachment`, сервер предлагает загрузку, даже когда расширение файла выглядит как PDF. Если заголовка нет, но у ссылки стоит `download`, инициатором становится HTML.

Получите заголовки именно конечного ответа после CDN и redirect. Проверка файла на диске не показывает, что пришло по HTTP, а просмотр конфигурации origin не учитывает правила proxy. Исправлять нужно слой, который сформировал фактический ответ.

Три сигнала читаются вместе

HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: inline; filename="report.pdf"
Content-Length: 482031
X-Content-Type-Options: nosniff

<a href="/files/report.pdf">Открыть отчёт</a>

Пример описывает намерение показать PDF обычным способом. RFC 6266 определяет `attachment` как предложение сохранить ответ локально, а `inline` — как обычную обработку. RFC 9110 указывает, что Content-Type задаёт media type и способ интерпретации представления. Само `inline` не добавляет браузеру поддержку неизвестного формата.

Матрица быстро находит владельца поведения

НаблюдениеВероятный источникИсправление
attachment в ответеOrigin/CDN/proxyУбрать или заменить для preview-route
application/octet-streamНеверный MIMEОтдавать фактический тип
У ссылки есть downloadHTML-шаблонУбрать атрибут для открытия
Первый ответ 302Redirect/storageПроверить конечные headers
Только один браузер скачиваетНастройка/поддержка клиентаСравнить чистый профиль
Ответ — HTML ошибкиПрава или signed URLИсправить status и доступ

Не ориентируйтесь только на расширение. `report.pdf` с `text/html` может оказаться страницей авторизации, а URL без расширения корректно покажет PDF при media type `application/pdf`. При `nosniff` браузер не должен угадывать другой тип вместо объявленного, поэтому ошибка Content-Type становится заметнее и безопаснее.

Открытие и скачивание лучше разделить на два действия

  • Preview-route проверяет право и отдаёт inline с корректным MIME.
  • Download-route отдаёт attachment и безопасное имя файла.
  • Обе точки используют один объект и одинаковую проверку доступа.
  • Имя в filename не строится напрямую из непроверенного ввода.
  • Signed URL живёт ограниченное время и не попадает в публичный HTML.
  • Кеш учитывает различия авторизации и не раскрывает private файл.

Такой дизайн не заставляет угадывать намерение по query-параметру. Кнопка «Открыть» и кнопка «Скачать» имеют разные routes и тесты. Для приватного документа Content-Disposition не заменяет контроль доступа: зная URL, пользователь всё равно получает байты.

CDN может вернуть старые метаданные

Если origin уже отдаёт inline, а публичный URL всё ещё содержит attachment, сравните ответы напрямую и через CDN. Метаданные объекта в S3-совместимом хранилище также могут формировать Content-Type и Content-Disposition. После изменения инвалидируйте только нужный объект или смените его версию согласно политике CDN.

Не подменяйте PDF на `text/plain` ради открытия. Неверный media type ломает обработку и может создать риск MIME sniffing. Исправьте метаданные при загрузке или response headers на контролируемом endpoint.

Приёмка учитывает выбор пользователя

  1. Проверить status и headers конечного URL без сессии, если файл публичный.
  2. Открыть ссылку без download в двух актуальных браузерах.
  3. Проверить отдельную кнопку скачивания и безопасное имя.
  4. Повторить тест для файла с кириллицей в имени.
  5. Убедиться, что приватный URL недоступен другому пользователю.
  6. Проверить поведение после очистки или обновления cache.

Результат готов, когда server intent совпадает с интерфейсом: preview открывается там, где формат поддерживается, download сохраняет файл, а права одинаковы в обеих ветках. Настройки браузера пользователя могут всё равно выбрать внешнее приложение или загрузку — сайт не должен обходить этот выбор.

Проверенные источники