Spring接口接收MultipartFile时出现MultipartException及IOFileUploadException如何解决

• 开启底层日志捕获异常上下文：添加如下日志配置，即可在请求进入业务代码前打印多部件解析的全流程日志，关联触发异常的请求IP、请求头、请求大小信息：

# 开启Tomcat访问日志
server.tomcat.accesslog.enabled=true
server.tomcat.accesslog.pattern=%h %l %u %t "%r" %s %b %D
# 开启多部件解析相关组件的DEBUG日志
logging.level.org.apache.tomcat.util.http.fileupload=DEBUG
logging.level.org.springframework.web.multipart=DEBUG

• 排查链路超时/断连原因：EOFException本质是请求体还未完全传输完成时，连接就被主动断开，优先排查链路各节点的配置：
  • 客户端侧：是否上传大文件时用户主动退出页面、弱网中断、客户端上传超时时间设置过短
  • 中间节点：是否有CDN、反向代理、网关的请求大小限制、传输超时时间设置小于业务上传所需的时间
  • 服务端侧：检查当前配置的连接超时、上传大小限制是否符合业务要求
• 排查Tomcat版本bug：Tomcat 9.0.46存在已知的多部件解析边缘场景bug，会在特定请求格式下误抛EOF异常，可先和日志中的触发请求特征做匹配验证。

• 调整全链路配置：根据业务最大上传文件大小、预估最长传输时间，调整全链路配置：

# Spring Boot上传大小限制
spring.servlet.multipart.max-file-size=1024MB
spring.servlet.multipart.max-request-size=1024MB
# Tomcat连接超时设置为120秒，可根据业务调整
server.tomcat.connection-timeout=120000

同步调整反向代理（如Nginx）的client_max_body_size、proxy_read_timeout配置，网关/CDN的上传超时、大小限制规则。

• 全局捕获异常做兼容处理：通过全局异常处理器捕获该类非业务异常，打印自定义日志同时返回友好提示：

@ControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(MultipartException.class)
    public ResponseEntity<Result> handleMultipartException(MultipartException e) {
        // 自定义日志打印逻辑
        log.error("文件上传解析失败", e);
        // 返回友好提示
        return ResponseEntity.ok(Result.fail("上传中断，请检查网络后重试"));
    }
}

• 修复Tomcat版本bug：如果排查确认是Tomcat版本问题，可单独指定内置Tomcat版本升级到9.0.65+稳定版，或者将Spring Boot升级到2.4.13以上的补丁版本，即可修复该类解析bug。

内容的提问来源于stack exchange，提问作者João Durante