Когда загрузка файла обрывается, запишите четыре значения: размер файла, время до сбоя, HTTP-статус и сколько байтов получил сервер. Если сбой всегда происходит на одном размере, ищите лимит. Если через одинаковое число секунд — таймаут. Если только на мобильной сети — разрыв соединения и отсутствие возобновления. Сообщение «не удалось загрузить» без этих данных стирает главную улику.

Не начинайте с установки 2 ГБ во всех конфигурациях. У запроса есть несколько ворот: CDN или балансировщик, reverse proxy, веб-сервер, PHP/runtime, временный каталог, приложение и объектное хранилище. Итоговый предел задаёт самый маленький лимит, а бесконтрольное увеличение расходует диск и соединения и создаёт простой способ перегрузить сервис.

Момент сбоя указывает на слой

НаблюдениеВероятный слойЧто снять
ответ 413 сразуproxy или приложениеresponse headers и error log
$_FILES пуст, форма отправленаPHP post_max_sizeCONTENT_LENGTH и effective php.ini
обрыв через 60 секундproxy/runtime timeoutточное время и upstream status
ошибка после 100%проверка, обработка или storagejob status и application log
случайный обрыв на Wi-Fi/LTEсеть и монолитный uploadпринятые байты и retry
ошибка ENOSPCtmp или конечный дисксвободное место, inode и quota

В браузере сохраните HAR без cookie и откройте конкретный POST/PATCH: request size, duration, status и response body. На сервере свяжите его с request ID. Access log покажет, дошёл ли запрос до Nginx и сколько байтов принято; upstream log — был ли вызван runtime. Если в приложении нет записи, не переписывайте контроллер: запрос остановился раньше.

Лимиты выстраиваются как один бюджет

# nginx: применяется в подходящем http/server/location
client_max_body_size 64m;

; PHP: post_max_size больше одного файла и полей формы
upload_max_filesize = 60M
post_max_size = 64M
max_input_time = 300

# после изменения
nginx -t
php --ini

Числа приведены только как пример взаимного порядка. Nginx возвращает 413, если тело превышает client_max_body_size. В PHP post_max_size охватывает весь POST и должен быть больше upload_max_filesize; при превышении POST суперглобальные массивы могут оказаться пустыми. Проверьте именно effective-конфигурацию того SAPI, который обслуживает сайт: php CLI и PHP-FPM могут читать разные ini-файлы.

Временный файл должен пережить обработку

  • upload_tmp_dir существует, доступен пользователю runtime и находится на разделе с запасом места;
  • приложение проверяет upload error до попытки перемещения файла;
  • имя клиента не используется как путь, а MIME и расширение проверяются сервером;
  • антивирус, преобразование видео и создание превью выполняются после приёма в очереди;
  • неполные файлы получают срок жизни и удаляются отдельной безопасной задачей;
  • метрика различает принятые байты, успешно сохранённые объекты и завершённую обработку.

Полоса «100%» в браузере часто означает только передачу тела запроса. После неё сервер ещё может считать hash, проверять формат, загружать объект в S3 или запускать конвертацию. Верните идентификатор загрузки и показывайте отдельный статус обработки. Длинную работу не держите внутри одного HTTP-запроса: это увеличивает шанс таймаута и делает повтор неясным.

Нестабильной сети нужна загрузка с продолжением

Для крупных файлов разбейте передачу на части или используйте стандартизованный resumable-протокол. В tus клиент узнаёт текущий Upload-Offset через HEAD и продолжает PATCH с нужного байта; сервер может объявить максимальный размер и проверить checksum. Идентификатор upload связывается с пользователем, а авторизация проверяется на каждом продолжении — знание URL не должно давать право дописывать чужой файл.

Повтор части должен быть идемпотентным относительно offset. Если клиент думает, что отправил 20 МБ, а сервер подтвердил 15 МБ, нельзя слепо дописать следующий chunk. После reconnect клиент сначала запрашивает подтверждённую позицию. Завершение публикует объект только после проверки общего размера и, при необходимости, hash.

Тестовая матрица ловит границу до пользователей

  1. Загрузить файлы чуть меньше, ровно на границе и чуть больше разрешённого размера.
  2. Повторить тест медленным соединением и оборвать сеть на середине resumable upload.
  3. Проверить ответы при заполненном tmp, недоступном storage и ошибке обработчика.
  4. Убедиться, что отклонённый файл не остаётся публичным и временные части очищаются.
  5. Сопоставить UI-статус, HTTP-код, request ID и серверную метрику завершения.

Для диагностики достаточно обезличенного тестового файла, HAR без токенов, фрагмента конфигурации лимитов, request ID и строк логов вокруг него. Пользовательские документы передавать не нужно. Меняйте один слой за раз, проверяйте конфигурацию перед reload и откатывайте значение, если тест показывает рост памяти, диска или занятых соединений.

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