Гайды

Почему не загружается файл — ошибка 413 и три причины, которые ловят всех

Иллюстрация: коробка застряла в узком проёме, рядом рулетка показывает разницу в пару сантиметров

Загрузка картинок — та часть проекта, которая ломается тише всех. Локально всё летает, на сервере пользователь жмёт «Загрузить», крутилка вертится — и либо ошибка 413, либо вообще ничего.

Начну с факта, который экономит час отладки: файл на 4 МБ может не пролезть в лимит 4,5 МБ. Это не мистика и не глюк хостинга — сейчас разберём, куда девается разница.

Симптом: 413 и его маскировки

Каноничный вид ошибки — код 413 Payload Too Large, «тело запроса слишком большое». Но увидишь ты его не всегда: у разных слоёв разные манеры.

  • Явный 413 в консоли браузера — повезло, диагноз готов.
  • FUNCTION_PAYLOAD_TOO_LARGE — то же самое на serverless-хостинге.
  • Запрос обрывается без ответа, в консоли «network error» — сервер закрыл соединение, не дослушав.
  • Тишина: запрос ушёл со статусом 200, а файла нет — это уже третья причина, файл не доехал.

Что означают сами коды, если путаешься, — в кодах ответа HTTP.

Причина 1: лимит тела запроса — и он не один

Главное недоразумение: люди ищут «тот самый» лимит, а лимитов на пути несколько, и срабатывает самый маленький. Запрос проходит цепочку, и любое звено может отрезать:

| Где стоит лимит | Типовое значение по умолчанию | |-----------------|-------------------------------| | nginx перед приложением | 1 МБ | | Разбор JSON в Express | 100 КБ | | Функции на serverless-хостинге | ~4,5 МБ, поднять нельзя | | Серверные действия в Next.js | 1 МБ |

Отсюда классика: «я же поставил 50 МБ в настройках приложения, почему 413?» — потому что до приложения запрос не дошёл, его срезал nginx на своём мегабайте.

Как чинить. Определи, кто именно ругается: если в ответе HTML-страница с надписью nginx — это веб-сервер, лимит правится в его конфиге (client_max_body_size). Если ответ пришёл от твоего кода — правь настройку фреймворка. А вот у serverless-функций потолок жёсткий и не поднимается вообще: там нужен другой подход, о нём в конце.

Причина 2: ты отправляешь картинку строкой

Вот и разгадка про «4 МБ не влезли в 4,5 МБ».

Многие уроки советуют прочитать файл в браузере и отправить его в JSON как строку base64 — это удобно, всё едет одним объектом. Но base64 записывает двоичные данные буквами, и объём растёт примерно на треть. Файл 4 МБ превращается в 5,4 МБ трафика. Плюс сверху лимит на разбор JSON, который куда строже лимита на файлы.

Как чинить: не кодируй файл в текст. Отправляй его как есть, через FormData — тогда файл едет двоичным блоком, без наценки:

const data = new FormData();
data.append('file', input.files[0]);
await fetch('/api/upload', { method: 'POST', body: data });

Причина 3: файл вообще не уехал

Если ошибки нет, а на сервере пусто — запрос ушёл пустым. Три виновника, по частоте:

Ты руками выставил заголовок. Самая обидная ошибка. К FormData нельзя дописывать Content-Type вручную:

// сломано: граница между частями потеряна, сервер не разберёт
fetch(url, { method: 'POST', body: data, headers: { 'Content-Type': 'multipart/form-data' } });

Браузер сам подставляет этот заголовок вместе со случайной строкой-разделителем. Написав его руками, ты разделитель стираешь — и сервер видит кашу вместо файла. Просто не трогай заголовок.

У поля нет имени. У input типа file должен быть атрибут name — по нему сервер ищет файл. Без него поле отправится в никуда.

Обычная форма без нужного enctype. Если отправляешь классической HTML-формой, а не через код, ей нужен атрибут enctype="multipart/form-data", иначе браузер пошлёт только имя файла, а не содержимое.

Правильный путь: не гонять файл через свой сервер

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

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

Плюсы очевидны: лимиты на тело запроса перестают существовать как класс, сервер не занят перекачкой байт, а хостинг не считает тебе лишний трафик. Пошагово этот путь разобран в как добавить загрузку картинок.

Локально работает, на проде 413 — почему?

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

Как понять, чей именно это лимит?

Смотри на тело ответа, а не только на код. HTML-страница с названием веб-сервера — режет он. JSON в формате твоего приложения — режет фреймворк. Название платформы в тексте ошибки — потолок хостинга. И проверь размер бинарно: отправь файл на 100 КБ. Прошёл — дело в размере, не прошёл — дело в форме.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →