Расширение `.jpg` в ключе объекта не гарантирует заголовок `image/jpeg`. Для S3 Content-Type — метаданные, которые задаются при создании объекта. Если uploader не передал тип или определил его неверно, клиент получит `application/octet-stream`, хотя сами байты изображения останутся целыми.

Сначала выполните HEAD-запрос к объекту напрямую в хранилище, затем такой же запрос через CDN или ваш файловый endpoint. Разные ответы означают проблему прокси или кеша. Одинаковый неверный Content-Type указывает на загрузчик или уже сохранённые метаданные.

Не путайте четыре независимые вещи

УровеньЧто хранитКак проявляется ошибка
Ключ объектаИмя и условное расширениеФайл называется правильно, но заголовок неверен
БайтыФактическое содержимоеПросмотрщик сообщает о повреждённом или неожиданном формате
Метаданные S3Content-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 и ключи доступа замените безопасными примерами.

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