解决SpringBoot文件上传报错：org.apache.tomcat.util.http.fileupload.impl.FileSizeLimitExceededException

Posted 2023-02-20 小花皮猪

问题描述

今天写了一个文件上传到本地进行接口测试，没想到报错了：

日志如下：

org.apache.tomcat.util.http.fileupload.impl.FileSizeLimitExceededException: The field file exceeds its maximum permitted size of 1048576 bytes.
at org.apache.tomcat.util.http.fileupload.impl.FileItemStreamImpl$1.raiseError(FileItemStreamImpl.java:112) ~[tomcat-embed-core-9.0.36.jar:9.0.36]
at org.apache.tomcat.util.http.fileupload.util.LimitedInputStream.checkLimit(LimitedInputStream.java:76) ~[tomcat-embed-core-9.0.36.jar:9.0.36]
at org.apache.tomcat.util.http.fileupload.util.LimitedInputStream.read(LimitedInputStream.java:135) ~[tomcat-embed-core-9.0.36.jar:9.0.36]

分析问题

通过日志可以发现报错原因，无非就是上传的文件太大了，超过了SpringBoot默认的配置

tomcat默认上传的单个文件大小限制是1M，同时上传默认的文件大小是10M

解决这个问题很简单，只需要修改SpringBoot默认的文件大小配置即可。

在开始解决问题之前，我先把报错的代码发出来供大家参考：

这里只是测试接口，代码处理的有点糙。

package com.wyh.controller;

import com.wyh.common.Result;
import com.wyh.entity.User;
import com.wyh.service.impl.IUserServiceImpl;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.multipart.MultipartFile;

import javax.annotation.Resource;
import java.io.File;
import java.io.IOException;
import java.util.UUID;

/**
 * @Description: 用户控制器
 * @Author: 魏一鹤
 * @Date: 2022-11-30 22:47
 **/
@RestController
@RequestMapping("/user")
public class UserController 
    @Resource
    IUserServiceImpl userService;
    //存储图片的路径 
    private String basePath = "D:\\\\test\\\\";


    /**
     * @Author 魏一鹤
     * @Description 上传文件
     * @Date 21:12 2023/2/5
     **/
    @PostMapping("/upload")
    public Result upload(MultipartFile file) 
        System.out.println("file=======" + file);
        String originalFilename = file.getOriginalFilename();
        System.out.println("originalFilename=====" + originalFilename);
        String suffix = originalFilename.substring(originalFilename.lastIndexOf("."));
        String fileName = UUID.randomUUID().toString() + suffix;//dfsdfdfd.jpg
        //创建一个目录对象
        File dir = new File(basePath);
        //判断当前目录是否存在
        if (!dir.exists()) 
            //目录不存在，需要创建
            dir.mkdirs();
          //将临时文件转存到指定位置
        try 
            file.transferTo(new File(basePath + fileName));
         catch (IOException e) 
            e.printStackTrace();
        
        return Result.ok("上传成功！");
    

解决问题:修改文件大小

修改配置信息即可，在application.properties(yaml)中设置文件大小：

# 最大上传单个文件大小：默认1M  如果改为-1说明无大小限制
spring.servlet.multipart.max-file-size=5MB
# 最大总上传的数据大小:默认10M(对同时上传多个文件大小的限制） 如果改为-1说明无大小限制
spring.servlet.multipart.max-request-size=50MB

无大小限制

如果把上面的配置项改为-1，那么就是说明没有大小限制，我没有这么试过，只是知道这一说！

重启服务，验证问题

修改过配置文件之后，就可以重启服务，验证刚才的配置是否有效。

再次选择一样的文件，重新上传，问题解决。

总结

这类问题还是很好解决的，修改默认文件大小配置的时候要根据自己的需求灵活修改。