К содержимому

Ошибка 413 Request Entity Too Large в nginx: как исправить

Ошибка 413 Request Entity Too Large означает, что размер запроса превышает лимит, заданный директивой client_max_body_size в nginx. Сначала проверьте значение этой директивы в конфигурации вашего сайта или в блоке http, затем увеличьте его и перезагрузите nginx.

Ошибка Деплой 2 мин чтения

01Маленький client_max_body_size в конфиге nginx

По умолчанию nginx ограничивает размер тела запроса одним мегабайтом. Если вы загружаете файл больше этого значения, сервер возвращает 413. Проверьте действующее значение командой nginx -T и поиском по выводу. Увеличьте директиву в блоке server или http и перезагрузите nginx.

nginx
server {
    listen 80;
    server_name example.com;
    root /var/www/example.com/public;

    client_max_body_size 20m;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.3-fpm.sock;
    }
}

02Лимит PHP: upload_max_filesize и post_max_size

Даже если nginx пропускает большой запрос, PHP может отклонить его из-за собственных ограничений. Директива upload_max_filesize задаёт максимальный размер файла, а post_max_size ограничивает весь POST-запрос. Проверьте текущие значения через php -i или в файле php.ini для PHP 8.3. Установите post_max_size не меньше upload_max_filesize, а оба значения согласуйте с client_max_body_size.

ini
upload_max_filesize = 20M
post_max_size = 20M
max_execution_time = 300

03Ограничение в PHP-FPM

В пуле PHP-FPM может быть задан параметр php_admin_value[upload_max_filesize] или php_admin_value[post_max_size], который перекрывает настройки php.ini. Проверьте файл пула, обычно /etc/php/8.3/fpm/pool.d/www.conf. Если такие строки есть, измените значения и перезапустите PHP-FPM.

bash
sudo grep -n 'upload_max_filesize\|post_max_size' /etc/php/8.3/fpm/pool.d/www.conf
sudo systemctl restart php8.3-fpm

04Проверка после изменений

После правок проверьте синтаксис конфигурации nginx и перезагрузите его без разрыва соединений. Убедитесь, что PHP-FPM перезапущен, если менялись его настройки. Затем повторите загрузку файла, который раньше вызывал ошибку. Если 413 остаётся, проверьте, не переопределяет ли директиву другой блок server или location.

bash
sudo nginx -t
sudo systemctl reload nginx
sudo systemctl status php8.3-fpm

Что не помогает

  • Увеличить только client_max_body_size, не трогая настройки PHP.

    Согласуйте лимиты: client_max_body_size в nginx, upload_max_filesize и post_max_size в php.ini и пуле PHP-FPM. Иначе большой файл пройдёт через nginx, но будет отклонён PHP.

  • Забыть перезагрузить nginx после изменения конфигурации.

    Выполните sudo nginx -t для проверки и sudo systemctl reload nginx для применения. Без перезагрузки старые лимиты остаются в силе.

  • Поставить очень большое значение client_max_body_size без необходимости.

    Указывайте лимит чуть выше максимального размера загружаемых файлов. Слишком большое значение увеличивает риск исчерпания памяти и диска при массовых загрузках.

Deploykin

Как это делается в Deploykin

В Deploykin авто-тюнинг выставляет лимит загрузки nginx равным лимиту PHP. Настройки nginx и PHP-FPM сайта меняются в панели: она сама перегенерирует конфиг, проверит его и применит.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Где задаётся client_max_body_size в nginx?

Директиву можно задать в блоках http, server или location. Значение из location перекрывает server, а server перекрывает http. Ищите её в файлах сайта в /etc/nginx/sites-enabled/ или в основном /etc/nginx/nginx.conf.

Почему после увеличения client_max_body_size ошибка 413 осталась?

Вероятно, директива переопределена в другом блоке location или server, либо nginx не был перезагружен. Проверьте полную конфигурацию командой sudo nginx -T и найдите все вхождения client_max_body_size.

Достаточно ли изменить только client_max_body_size?

Нет. PHP имеет собственные лимиты upload_max_filesize и post_max_size. Если они меньше размера файла, загрузка завершится ошибкой уже на стороне PHP.

Как проверить, что ошибка 413 исчезла?

Загрузите файл, который раньше вызывал ошибку, и убедитесь, что он сохранился. В логах nginx (/var/log/nginx/error.log) не должно быть записей о превышении размера тела запроса.

Ещё по теме

Деплой Laravel на сервер: команды, конфиг и ошибки: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.