Почему не загружается файл — ошибка 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 коротких урока на телефоне.





