原因
上传文件时,请求参数过大,导致超出服务端限制。
客户端发送的实体主体部分比服务器能够或者希望处理的要大。
解决
Nginx默认最大能够上传1MB文件,打开nginx.conf在http{}中,找到server{}设置:
client_max_body_size 30m;(配置客户端请求实体最大值)
client_body_buffer_size 128k;(配置请求体缓存区大小)
client_max_body_size
client_max_body_size 默认 1M,表示 客户端请求服务器最大允许大小,在“Content-Length”请求头中指定。如果请求的正文数据大于client_max_body_size,HTTP协议会报错 413 Request Entity Too Large。如果需要上传大文件,一定要修改该值。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相同的值,这样就不会存储临时文件,直接存储在内存了。
当请求为GET请求时,可以在nginx.conf的http{}中,找到server{}设置:
client_header_buffer_size 2k;
large_client_header_buffers 4 16k;
具体大小根据实际情况而定,这里仅做示例
client_header_buffer_size
client_header_buffer_size 默认值:1k,这个指令表示客户端请求的http头部缓冲区大小。绝大多数情况,下一个头部请求的大小不会大于1k。不过如果有来自于wap客户端的较大的cookie它可能会大于1k,Nginx将分配给它一个更大的缓冲区,这个值可以在large_client_header_buffers里面设置。
large_client_header_buffers
默认值:large_client_header_buffers 4 4k,指令表示客户端请求的一些比较大的头文件到缓冲区的最大值。如果一个请求的URI大小超过这个值,服务器将返回一个”Request URI too large” (414),同样如果一个请求的头部字段大于这个值,服务器将返回”Bad request”(400)。
缓冲区根据需求的不同是分开的。 默认一个缓冲区大小为操作系统中分页文件大小,通常是4k或8k,如果一个连接请求将状态转换为 keep-alive,这个缓冲区将被释放。
总结 文件无法上传大概就有以下四个方面的原因:
服务器对上传文件带下做了限制(Nginx,Apache,IIS等服务器,文中仅对Nginx配置做了说明)
网关对上传文件大小做了限制,此时添加配置即可。
SpringBoot/Spring对上传文件大小做了限制,添加配置即可。
文件确实过大,前后端链接超时,自动断开链接,可自己设置断点续传。