Успешный PUT в хранилище и статус «файл готов» в приложении — два разных события. Если браузер закрылся между ними, серверу нужен восстанавливаемый процесс подтверждения. Создайте запись намерения загрузки до выдачи URL, а готовность устанавливайте после серверной проверки конкретного результата. Сообщение клиента «загружено» само по себе не является доказательством.

Намерение связывает пользователя, разрешённый ключ, ожидаемые ограничения и срок. Клиент передаёт серверный upload ID, а не выбирает произвольный бакет или чужой object key. Ни подписанная ссылка, ни знание ключа не заменяют проверку принадлежности записи при финализации.

Сначала определите переход в готовность

Статус приложенияЧто подтверждено
Ожидается загрузкаРазрешение выдано, объекта может ещё не быть
ПроверяетсяСервер сверяет разрешённый результат
ГотовЗафиксирован именно проверенный результат
ОтклонёнПроверка не пройдена, публикации нет
Срок вышелТребуется предусмотренная новая попытка

HeadObject в Amazon S3 возвращает метаданные без тела объекта; это подтверждено документацией AWS, проверенной 21 октября 2026 года. Размер и тип полезны для сверки, но клиентский Content-Type не доказывает безопасное содержимое. Если политика требует анализа файла, он выполняется отдельно до готовности. Ошибку доступа к HEAD нельзя безусловно превращать в статус «файл отсутствует».

Проверенный объект нельзя незаметно заменить

AWS описывает presigned URL как повторно используемый до окончания срока; загрузка по тому же ключу может заменить объект. Поэтому возможна гонка: сервер проверил содержимое, а второй PUT изменил его перед использованием. В versioned-хранилище можно связать готовую запись с точным version ID и читать эту версию, если весь путь поддерживает такой контракт.

Условный контракт финализации:
upload ID -> авторизованная запись намерения
проверка -> точная версия или иной защищённый результат
готовность -> атомарная запись ссылки на этот результат
два finalize -> один итог, без двух публикаций
новый PUT -> не подменяет уже подтверждённую редакцию
сбой между шагами -> повтор сверяет прежний итог

Если version ID недоступен, спроектируйте другой способ закрепить проверяемый результат. Например, сервер получает его в закрытую область под своим управлением, анализирует полученную копию и публикует именно её, не перечитывая изменяемый источник. Ключ назначения и права записи выбирает сервер; простое переименование поля в базе не устраняет гонку.

Пропавший callback не должен оставлять вечный черновик

  • Повторный finalize возвращает уже известный итог.
  • Параллельные подтверждения согласуются по версии записи.
  • Незавершённые намерения имеют срок и процедуру сверки.
  • Фоновая сверка применяет те же проверки, что клиентский запрос.
  • Очистка исключает результаты активной проверки и готовые файлы.

Событие хранилища может инициировать такую сверку, но не отменяет проверку пользователя и ожидаемого результата. Для записи без callback нужно уметь отличить завершённый объект от брошенной попытки. Повторное событие не создаёт вторую запись вложения. Если хранилище временно недоступно, сохраните неопределённый статус и ограниченный повтор вместо ложной готовности.

При приёмке оборвите браузер после PUT, потеряйте ответ finalize и запустите два подтверждения одновременно. Затем повторите PUT в ещё действующее разрешение и убедитесь, что готовое вложение не изменилось. Используйте синтетические файлы. Откат обработчика сохраняет совместимость уже созданных намерений, а повреждённые старые статусы восстанавливаются отдельной сверкой.

Для внедрения подготовьте схему состояний, срок разрешения и способ закрепления проверенного содержимого. Начинайте с одного типа вложения и контролируйте возраст незавершённых намерений. Тогда потеря вкладки станет обычным восстанавливаемым случаем, а не поводом доверять клиентскому флажку или открывать доступ ко всем файлам.

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