Nginx 413 Request Entity Too Large，文件上传过程中的问题

小鱼儿 2023-02-22 08:09 69阅读 0赞

> 在上传时nginx返回了413错误，查看log文件，显示的错误信息是:”413 Request Entity Too Large”。  
> 以下介绍处理办法。

## 1 处理方式如下 ##

1.打开nginx配置文件 nginx.conf, 路径一般是：/etc/nginx/nginx.conf，或者/usr/local/nginx。  
2.在http\{\}段中加入 client\_max\_body\_size 20m; 20m为允许最大上传的大小。（设置超过20m可能无效）  
3.同时，还需要设置client\_body\_buffer\_size的值，要求client\_body\_buffer\_size<=client\_max\_body\_size 。可以直接设置两者相等大小。  
4.保存后重启nginx，问题解决。nginx操作可以参考 [nginx操作][nginx]。  
设置值如下：

client_max_body_size 20M;
        client_body_buffer_size 20M;

效果图如下：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3h1amluZ2dlbg_size_16_color_FFFFFF_t_70]

## 2 相关原理记录如下： ##

1）client\_max\_body\_size  
client\_max\_body\_size 默认 1M，表示 客户端请求服务器最大允许大小，在“Content-Length”请求头中指定。如果请求的正文数据大于client\_max\_body\_size，HTTP协议会报错 413 Request Entity Too Large。就是说如果请求的正文大于client\_max\_body\_size，一定是失败的。如果需要上传大文件，一定要修改该值。  
2）client\_body\_buffer\_size  
Nginx分配给请求数据的Buffer大小，如果请求的数据小于client\_body\_buffer\_size直接将数据先在内存中存储。如果请求的值大于client\_body\_buffer\_size小于client\_max\_body\_size，就会将数据先存储到临时文件中，在哪个临时文件中呢？client\_body\_temp 指定的路径中，默认该路径值是/tmp/.  
所以配置的client\_body\_temp地址，一定让执行的Nginx的用户组有读写权限。否则，当传输的数据大于client\_body\_buffer\_size，写进临时文件失败会报错。

总结  
传输的数据大于client\_max\_body\_size，一定是传不成功的。小于client\_body\_buffer\_size直接在内存中高效存储。如果大于client\_body\_buffer\_size小于client\_max\_body\_size会存储临时文件，临时文件一定要有权限。  
如果追求效率，就设置 client\_max\_body\_size client\_body\_buffer\_size相同的值，这样就不会存储临时文件，直接存储在内存了。

[nginx]: https://blog.csdn.net/dear_little_bear/article/details/104686396?ops_request_misc=%257B%2522request%255Fid%2522%253A%2522159367390519724839257501%2522%252C%2522scm%2522%253A%252220140713.130102334.pc%255Fblog.%2522%257D&request_id=159367390519724839257501&biz_id=0&utm_medium=distribute.pc_search_result.none-task-blog-2~blog~first_rank_v1~rank_blog_v1-1-104686396.pc_v1_rank_blog_v1&utm_term=nginx
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3h1amluZ2dlbg_size_16_color_FFFFFF_t_70]: https://img-blog.csdnimg.cn/2020070215101184.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3h1amluZ2dlbg==,size_16,color_FFFFFF,t_70