Не увеличивайте все тайм-ауты сразу. Возьмите один разрешённый файл известного размера и проследите четыре факта: сколько байтов отправил браузер, какой HTTP-статус вернул proxy, появился ли временный объект и создалась ли задача обработки. Первая отсутствующая точка показывает слой поломки.
Регистрация не должна держать человека на бесконечном spinner. Upload получает собственный ID и конечные состояния `uploaded`, `rejected` или `failed`; распознавание, антивирус и ручная проверка выполняются после приёма файла. Пользователь может обновить страницу и увидеть сохранённый этап, не заполняя анкету заново.
Симптом уже сужает участок поиска
| Наблюдение | Вероятный слой | Что открыть |
|---|---|---|
| 0% и запрос не появился | клиентская валидация или JavaScript | console и Network до отправки |
| обрыв на одном размере | proxy/app body limit | статус 413 и конфигурация лимитов |
| 100%, затем вечное ожидание | синхронная обработка | request duration, worker и очередь |
| успех, но файла нет | temp/storage commit | disk 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` из браузера недостаточно.
- Сохранить черновик анкеты до выбора файла.
- Создать upload ID и разрешить только ожидаемый тип документа.
- Принять файл во временное закрытое хранилище.
- Проверить фактический формат, размер и результат защитной обработки.
- Атомарно привязать готовый объект к анкете и удалить лишние attempts.
Набор тестов включает плохую сеть и плохой файл
Проверьте файл чуть меньше и чуть больше каждого лимита, нулевой файл, неверное расширение, медленную передачу, разрыв на середине, обновление страницы на 70% и повтор submit. Ожидаемый результат всегда конечен: принят, отклонён с причиной либо доступен безопасный повтор. Ни один вариант не создаёт опубликованный документ из частичного объекта.
После исправления метрики показывают длительность upload отдельно от обработки, долю 413/415/5xx и число брошенных attempts. Для обращения в поддержку нужны upload ID, время UTC, размер, тип, браузер и статус Network; сам документ, cookie авторизации и персональные данные не пересылаются в обычный технический чат.