Java MultipartFile 上传大文件踩坑（包含后续上线问题及解决）

最新推荐文章于 2025-06-06 17:34:13 发布

ATadpole

最新推荐文章于 2025-06-06 17:34:13 发布

阅读量5.7k

点赞数 3

CC 4.0 BY-SA版权

分类专栏： Java 文章标签： java linux nginx

本文链接：https://blog.youkuaiyun.com/ATadpole/article/details/108618539

9 篇文章

订阅专栏

本文详细介绍了在使用Java处理文件上传遇到的文件大小限制问题，包括调整Spring框架配置及nginx服务器设置，确保大文件上传的顺利进行。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

这是一个普通的编码的一天，在对接一个B端提供的文件上传接口，于是使用Java中的MultipartFile对象进行处理。这时就遇到了下图的错误

看异常名称就能了解到是文件过大引起的，那就需要修改默认的文件体积设置，具体设置如下：

spring:
  servlet:
    multipart:
      enabled: true
      max-file-size: 20MB  #单个文件最大大小
      max-request-size: 60MB #上传数据总大小

按照上面的设置完成之后，在开发环境测试没有出现问题。本以为已经成功了，在后续的一通上线操作之后，发现线上前端仍然是显示上传失败。

配合线上Java日志发现并没有任何报错信息，于是查看请求状态码，发现是413状态码（413 Request Entity Too Large），请求实体过大，那么这一层应该是在nginx接受到请求时，出现的问题。

由此推测，需要在nginx中进行设置，百度查询了一下，需要设置

client_max_body_size 60m;    #60可根据具体需求具体设置，但不能大于上述java中设置的max-request-size的值

且这个属性可以在http{}，server{}，location{}，这3个位置设置，对应不同的作用区间。

在/usr/local/nginx/conf/nginx.conf这个nginx配置文件中加上client_max_body_size 60m。

后续重启nginx（注意：nginx -s reload不行），网上有几个比较常用的重启方式，

service nginx restart

systemctl start nginx

上述的2种方式需要对nginx进行一些配置，我没有使用

1、cd /usr/local/nginx/sbin //切到nginx启动目录下

2、ps -ef|grep nginx //查看nginx 的运行进程

3、kill -QUIT 主进程号 //杀死nginx的主进程号

4、./nginx //启动nginx，如需要指向其他nginx配置 ./nginx -c 自定义配置路径