Не увеличивайте все тайм-ауты сразу. Возьмите один разрешённый файл известного размера и проследите четыре факта: сколько байтов отправил браузер, какой HTTP-статус вернул proxy, появился ли временный объект и создалась ли задача обработки. Первая отсутствующая точка показывает слой поломки.

Регистрация не должна держать человека на бесконечном spinner. Upload получает собственный ID и конечные состояния `uploaded`, `rejected` или `failed`; распознавание, антивирус и ручная проверка выполняются после приёма файла. Пользователь может обновить страницу и увидеть сохранённый этап, не заполняя анкету заново.

Симптом уже сужает участок поиска

НаблюдениеВероятный слойЧто открыть
0% и запрос не появилсяклиентская валидация или JavaScriptconsole и Network до отправки
обрыв на одном размереproxy/app body limitстатус 413 и конфигурация лимитов
100%, затем вечное ожиданиесинхронная обработкаrequest duration, worker и очередь
успех, но файла нетtemp/storage commitdisk space, права, object key
только на медленной сетиinput/read timeout или разрывбайты, время и server access log

Сообщение «зависло» замените временной шкалой: start, first byte, last byte, HTTP response, storage commit, job start и terminal result. На каждом шаге один upload ID. Без него запрос из браузера невозможно надёжно связать с worker log.

Лимит действует на самом раннем из слоёв

Nginx проверяет размер тела через `client_max_body_size` и при превышении возвращает 413. В PHP одновременно важны `upload_max_filesize`, более крупный `post_max_size`, число файлов и `max_input_time`; при превышении `post_max_size` массивы формы могут оказаться пустыми. CDN, ingress и application framework способны иметь собственные меньшие пределы.

request_id=req_84...
upload_id=up_31...
content_length=7340032
nginx_client_max_body_size=12m
php_upload_max_filesize=10M
php_post_max_size=12M
http_status=201
storage_bytes=7340032
sha256=...
processing_job=docscan_91...
  • Публиковать допустимый размер рядом с полем до начала отправки.
  • Проверять размер снова на сервере: клиентское ограничение можно изменить.
  • Настраивать предел только для нужного endpoint, а не безгранично для всего сайта.
  • Возвращать структурированный код ошибки, который интерфейс переводит в понятный текст.

Прогресс передачи и прогресс проверки — разные шкалы

События `XMLHttpRequest.upload` показывают передачу байтов, если известна общая длина. Они не говорят, что сервер сохранил документ или закончил проверку. После ответа 201 интерфейс переключается на состояние «файл принят», а статус обработки получает отдельным запросом по upload ID. Если total неизвестен, показывается объём и активная фаза без выдуманного процента.

Fetch не всегда даёт тот же удобный механизм upload progress в используемом стеке, поэтому выбирайте API осознанно. Главное — не доводить индикатор до 100% по таймеру. Прерывание пользователем должно отменять запрос и оставлять анкету сохранённой, а частичный временный объект — удаляться по TTL.

Повтор не создаёт второй документ

Клиент создаёт upload session и получает непрозрачный ID. Повтор после сетевого разрыва либо продолжает поддерживаемую multipart/resumable загрузку, либо начинает новый attempt, но сервер связывает результат с тем же полем анкеты. Commit выполняется после сверки размера, checksum и типа файла; простое доверие `Content-Type` из браузера недостаточно.

  1. Сохранить черновик анкеты до выбора файла.
  2. Создать upload ID и разрешить только ожидаемый тип документа.
  3. Принять файл во временное закрытое хранилище.
  4. Проверить фактический формат, размер и результат защитной обработки.
  5. Атомарно привязать готовый объект к анкете и удалить лишние attempts.

Набор тестов включает плохую сеть и плохой файл

Проверьте файл чуть меньше и чуть больше каждого лимита, нулевой файл, неверное расширение, медленную передачу, разрыв на середине, обновление страницы на 70% и повтор submit. Ожидаемый результат всегда конечен: принят, отклонён с причиной либо доступен безопасный повтор. Ни один вариант не создаёт опубликованный документ из частичного объекта.

После исправления метрики показывают длительность upload отдельно от обработки, долю 413/415/5xx и число брошенных attempts. Для обращения в поддержку нужны upload ID, время UTC, размер, тип, браузер и статус Network; сам документ, cookie авторизации и персональные данные не пересылаются в обычный технический чат.

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