Расширение `.jpg` в ключе объекта не гарантирует заголовок `image/jpeg`. Для S3 Content-Type — метаданные, которые задаются при создании объекта. Если uploader не передал тип или определил его неверно, клиент получит `application/octet-stream`, хотя сами байты изображения останутся целыми.
Сначала выполните HEAD-запрос к объекту напрямую в хранилище, затем такой же запрос через CDN или ваш файловый endpoint. Разные ответы означают проблему прокси или кеша. Одинаковый неверный Content-Type указывает на загрузчик или уже сохранённые метаданные.
Не путайте четыре независимые вещи
| Уровень | Что хранит | Как проявляется ошибка |
|---|---|---|
| Ключ объекта | Имя и условное расширение | Файл называется правильно, но заголовок неверен |
| Байты | Фактическое содержимое | Просмотрщик сообщает о повреждённом или неожиданном формате |
| Метаданные S3 | Content-Type и другие HTTP-поля | Браузер выбирает неправильный способ обработки |
| CDN или приложение | Кешированный либо переопределённый ответ | S3 уже исправлен, а пользователи видят старый заголовок |
Проверка только имени файла охватывает один уровень из четырёх. Нужны минимум Content-Type, Content-Length, ETag или version ID и первые байты файла в безопасной тестовой среде.
Где тип теряется при загрузке
Multipart-форма может прислать тип от браузера, backend — проигнорировать его, а SDK загрузить поток без ContentType. Другой вариант: приложение доверяет пользовательскому имени и ставит `image/png` для любого файла с расширением `.png`. Надёжный поток сопоставляет разрешённое расширение с фактическим форматом и только затем передаёт MIME-тип в S3.
upload_request:
key: public/2026/09/report-482.pdf
detected_media_type: application/pdf
content_type_sent_to_storage: application/pdf
original_filename: report.pdf
verification: signature_and_policy_matchПользовательский Content-Type полезен как подсказка, но не как доказательство безопасности. Для разрешённых форматов проверьте сигнатуру и ограничения размера. HTML или SVG требуют отдельной модели риска: активное содержимое не стоит раздавать с доверенного домена только потому, что расширение прошло список.
Почему редактирование записи в базе не помогает объекту
Если приложение хранит MIME-тип в собственной таблице, изменение этой строки не переписывает метаданные уже загруженного объекта. Исправлять нужно и источник истины приложения, и сам объект. В S3 Content-Type относится к управляемым пользователем системным метаданным объекта.
Массовое исправление сначала запускайте в режиме отчёта: ключ, текущий тип, ожидаемый тип, version ID и действие. Перезапись метаданных может создать новую версию объекта и повлиять на ETag, события и кеш. Поэтому сделайте резервный список затронутых ключей и проверьте несколько представителей каждого формата.
CDN способен скрыть успешное исправление
После изменения объекта браузер всё ещё может получать старый закешированный заголовок. Сравните прямой ответ S3 и ответ публичного домена, учтите Cache-Control и ключ кеша. Не очищайте весь CDN вслепую: точечная инвалидация или versioned URL уменьшает побочный эффект.
- Проверьте новый объект сразу после upload через HEAD.
- Откройте файл через тот же URL, которым пользуется клиент.
- Сравните поведение inline и download отдельно от Content-Type.
- Повторная загрузка того же файла должна давать одинаковые метаданные.
Критерий готовности исправления
Возьмите тестовые JPEG, PDF, ZIP и файл с намеренно ложным расширением. Первые три должны получить ожидаемые разрешённые типы, последний — быть отклонён или изолирован согласно политике. HEAD от хранилища и CDN должен совпасть, а интерфейс не должен полагаться только на имя.
Для разбора подготовьте обезличенный ключ, результат HEAD с двух точек, параметры SDK при PUT и правило определения формата. Подписанные URL и ключи доступа замените безопасными примерами.