Ошибка 413 Request Entity Too Large в nginx: как исправить
Ошибка 413 Request Entity Too Large означает, что размер запроса превышает лимит, заданный директивой client_max_body_size в nginx. Сначала проверьте значение этой директивы в конфигурации вашего сайта или в блоке http, затем увеличьте его и перезагрузите nginx.
01Маленький client_max_body_size в конфиге nginx
По умолчанию nginx ограничивает размер тела запроса одним мегабайтом. Если вы загружаете файл больше этого значения, сервер возвращает 413. Проверьте действующее значение командой nginx -T и поиском по выводу. Увеличьте директиву в блоке server или http и перезагрузите 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.
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.
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.
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) не должно быть записей о превышении размера тела запроса.
Ещё по теме
- Ошибка · Деплой Ошибка 500 в Laravel: где искать причину и как исправить Разбираем ошибку 500 в Laravel: где смотреть логи, как проверить права на storage и bootstrap/cache, APP_KEY, синтаксис nginx и PHP-FPM. Команды для диагностики и…
- Ошибка · Деплой php artisan migrate ошибка: причины и исправление Разбираем ошибки php artisan migrate: отказ доступа к MySQL, неверный.env, права на storage. Команды проверки, конфиг nginx и PHP 8.3, как убедиться, что миграции…
- Ошибка · Деплой Ошибка composer install: как найти причину и исправить Разбираем ошибки composer install: нехватка памяти, права доступа, версия PHP. Команды для диагностики и исправления на Ubuntu 24.04 с nginx, PHP 8.3 и MySQL 8.
- Ошибка · Деплой Ошибка git pull permission denied на VPS: как исправить Разбираем ошибку git pull permission denied на VPS: проверка прав, SSH-ключей, владельца файлов и конфигурации nginx. Команды для диагностики и исправления.
- Ошибка · Деплой Ошибка 419 Page Expired в Laravel: причины и исправление Почему Laravel выдаёт 419 Page Expired: CSRF-токен, cookie сессии, SESSION_DOMAIN, кэш конфига. Как проверить и исправить каждую причину.
- Руководство · Деплой Как развернуть сайт на VPS: Laravel и PHP на Ubuntu 24.04 Пошаговый деплой сайта на VPS: nginx, PHP 8.3, MySQL 8, git clone, composer install, миграции, права на storage и проверка через curl.
Деплой Laravel на сервер: команды, конфиг и ошибки: все материалы темы