Nginx 出现 413 Request Entity Too Large

问题

利用fastDFS文件服务器上传超过1M文件时出现413 Request Entity Too Large报错。

原因

排查后发现是nginx的client_max_body_size指令的默认值为1 MiB导致的。

解释

它可以被设置在http，server和location语境-如在大多数情况下，该指令在嵌套块优先于祖先块相同的指令。

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，一定是失败的。如果需要上传大文件，一定要修改该值。

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，写进临时文件失败会报错。
 

设置客户端请求正文的最大允许大小，在“Content-Length”请求标头字段中指定。如果请求中的大小超过配置的值，则会将413（请求实体太大）错误返回给客户端。请注意，浏览器无法正确显示此错误。将大小设置为0将禁用检查客户端请求正文大小。

解决

总结

传输的数据大于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主配置文件nginx.conf，一般在/usr/local/nginx/conf/nginx.conf这个位置，找到http{}段，修改或者添加

vim /usr/local/nginx/conf/nginx.conf

client_max_body_size 20m;
client_body_buffer_size 20m;

重启nginx

/usr/local/nginx/sbin/nginx -s reload