错误信息

前端页面上传文件时报错，nginx的报错信息是
413 Request Entity Too Large

错误分析

客户端上传文件大小超过了nginx的限制（默认为1M），官方文档

  1. Syntax:    client_max_body_size size;
  2. Default:    client_max_body_size 1m;
  3. Context:    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，写进临时文件失败会报错。

总结

传输的数据大于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配置文件的http{} 段中增大nginx上传文件大小限制，并且

  1. client_max_body_size 1024M;
  2. client_body_buffer_size 1M;

修改过后，重启nginx服务

注意

  • 设置到http{}内，控制全局nginx所有请求报文(附件)大小；
  • 设置到server{}内，控制该server的所有请求报文(附件)大小；
  • 设置到location{}内，只控制满足该路由规则的请求报文(附件)大小；