Если Next.js Route Handler не выдерживает большой файл, отделите отказ до приложения от перегрузки при чтении тела. Запишите статус, принятые байты, время и память процесса на согласованном тестовом файле. Не увеличивайте все лимиты: обработчик может сохранять несколько представлений одного файла одновременно.

Проверяйте на стенде с ограничением размера, параллелизма и времени. Используйте искусственный файл без клиентских данных. В production большие повторные загрузки могут занять память и соединения; такой эксперимент требует отдельного разрешения. Запишите App Router или Pages Router и среду размещения: у них нельзя предполагать одинаковый путь обработки.

Где закончилась передача

НаблюдениеОбласть проверкиЧто сохранить
Приложение не увидело запросПрокси или платформаСтатус и фактическую границу
Запрос начался, тело не дочитаноПередача или чтениеПринятые байты и время
Память растёт при обработкеКопии и преобразованияПрофиль одного и нескольких запросов
Байты приняты, файл не готовХранилище и подтверждениеСостояние объекта и операции

В текущей документации Route Handlers Next.js чтение FormData показано через request.formData(). Источник проверен 12 октября 2026 года. Наличие этого метода не обещает неограниченный размер или потоковую обработку без накопления. Конкретную границу определяют реализация, runtime и платформа; не переносите в обработчик случайное число из чужого хостинга.

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

Передать байты можно отдельно от бизнес-команды

Условный протокол, не готовый API:
1. upload intent: сервер разрешает собственный объект
2. binary upload: клиент передаёт байты в хранилище
3. finalize: сервер проверяет объект и связывает с записью
неизвестный исход: выяснение состояния
брошенный объект: согласованная очистка

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

Полученный объект сначала может находиться в промежуточной области. Тип из имени или заголовка клиента не доказывает содержимое. Для непроверенного файла задайте закрытый доступ и отдельное состояние; не публикуйте его сразу по постоянной ссылке. Если операция прервалась, временные объекты должны иметь владельца и правило удаления.

Что испытать кроме одной удачной загрузки

  1. Принять небольшой разрешённый файл.
  2. Проверить отказ для превышения согласованного размера.
  3. Прервать передачу и выяснить состояние объекта.
  4. Повторить finalize без второй бизнес-записи.
  5. Испытать параллельные загрузки в разрешённых границах.

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

Для задачи подготовьте версию Next.js, путь запроса, тестовый объём и профиль памяти по этапам. Выбранное исправление должно дать контролируемый отказ на границе, корректное завершение и понятную очистку. Быстрый ответ сервера без готового проверенного файла не считается успешной загрузкой.

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