上传文件报错 org.apache.tomcat.util.http.fileupload.impl.FileSizeLimitExceededException: The field file e

1. 修改配置文件（推荐）

根据你使用的配置文件格式（.yml或.properties），添加以下配置将限制提升到 20MB（或者更大，比如 30MB 以防万一）。

如果是application.yml：

spring:servlet:multipart:enabled:truemax-file-size:30MB# 单个文件大小限制max-request-size:30MB# 整个请求（包含文件和参数）的大小限制

如果是application.properties：

spring.servlet.multipart.enabled=true spring.servlet.multipart.max-file-size=30MB spring.servlet.multipart.max-request-size=30MB

注意版本差异：

• Spring Boot 2.x / 3.x (Java 11 常用): 使用spring.servlet.multipart...(如上所示)。
• Spring Boot 1.5.x (较老): 使用spring.http.multipart...。

---

2. 处理异常（建议）

由于这个异常是在 Controller 之外抛出的，你的GlobalExceptionHandler虽然捕获到了，但打印了堆栈信息。为了给前端返回友好的提示（而不是 500 错误），建议在你的GlobalExceptionHandler中专门处理这个异常：

importorg.springframework.web.multipart.MaxUploadSizeExceededException;importorg.springframework.web.bind.annotation.ExceptionHandler;// ... 其他 import// 在 GlobalExceptionHandler 类中添加@ExceptionHandler(MaxUploadSizeExceededException.class)publicHttpResponse<String>handleMaxUploadSizeExceededException(MaxUploadSizeExceededExceptione){// 这里的 HttpResponse 替换为你项目中实际的统一返回对象returnHttpResponse.error(500,"上传文件过大，请上传不超过20MB的文件");}

---

3. 如果使用了 Nginx（重要）

如果你的 Java 服务前面挂了 Nginx，只改 Java 配置是不够的，Nginx 默认限制也是 1MB。你需要修改nginx.conf：

http { # ... 其他配置 client_max_body_size 30m; # 设置为比 Java 配置稍大一点 # ... }

修改后记得重启 Nginx (nginx -s reload)。