В этой ситуации браузер часто выполняет ровно то, что ему сообщили. Если ответ содержит `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 | Отдавать фактический тип |
| У ссылки есть download | HTML-шаблон | Убрать атрибут для открытия |
| Первый ответ 302 | Redirect/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.
Приёмка учитывает выбор пользователя
- Проверить status и headers конечного URL без сессии, если файл публичный.
- Открыть ссылку без download в двух актуальных браузерах.
- Проверить отдельную кнопку скачивания и безопасное имя.
- Повторить тест для файла с кириллицей в имени.
- Убедиться, что приватный URL недоступен другому пользователю.
- Проверить поведение после очистки или обновления cache.
Результат готов, когда server intent совпадает с интерфейсом: preview открывается там, где формат поддерживается, download сохраняет файл, а права одинаковы в обеих ветках. Настройки браузера пользователя могут всё равно выбрать внешнее приложение или загрузку — сайт не должен обходить этот выбор.