当前位置：首页 > news >正文

文件上传过程中出现EOFException的解决方案

news 2025/8/4 18:36:23

文件上传过程中出现EOFException的解决方案

项目场景：

项目是一个考试测评系统，包含学生答题截图上传功能。学生通过前端界面提交答题截图，后端服务接收并处理这些图片文件，存储到MinIO对象存储中。

问题描述

前端调用’提交答题截图’接口后，后端报EOFException错误。错误日志显示在处理multipart/form-data请求时连接意外终止，导致文件上传失败。具体表现为：

2025-04-23 14:40:42.033 ERROR 14988 — [nio-8080-exec-4]
o.a.c.c.C.[.[.[/].[dispatcherServlet] : Servlet.service() for servlet
[dispatcherServlet] in context with path [] threw exception [Request
processing failed; nested exception is
org.springframework.web.multipart.MultipartException: Failed to parse
multipart servlet request; nested exception is java.io.IOException:
org.apache.tomcat.util.http.fileupload.impl.IOFileUploadException:
Processing of multipart/form-data request failed.
java.io.EOFException] with root cause java.io.EOFException: null

原因分析：

连接超时：上传较大文件时可能超过Tomcat默认的连接超时时间
网络不稳定：客户端与服务器之间的网络连接可能中断
缓冲区不足：Tomcat的接收缓冲区大小不足以处理大文件
配置限制：默认的multipart配置可能不适合实际文件上传需求

解决方案：

1. 调整Tomcat和Multipart配置

在application.yml中添加以下配置：

spring:servlet:multipart:max-file-size: 10MBmax-request-size: 100MBenabled: truefile-size-threshold: 2KB  # 文件超过2KB就写入磁盘server:tomcat:max-http-form-post-size: 100MBconnection-timeout: 180000  # 3分钟超时max-swallow-size: -1  # 不限制请求体大小max-http-header-size: 8192  # 增加HTTP头部大小

增强Controller层的错误处理
修改StudentController中的文件上传方法：

@ApiOperation(value = "提交答题截图")
@PostMapping("/submit")
public Result submit(@RequestParam("examCard") String examCard,@RequestParam(value = "screenShot", required = false) MultipartFile screenShot) {try {log.info(examCard+"正在提交答题截图"+(screenShot != null ? screenShot.getOriginalFilename() : "无文件"));// 空文件检查if (screenShot == null || screenShot.isEmpty()) {return Result.error("截图文件不能为空");}// 文件类型验证String contentType = screenShot.getContentType();if (contentType == null || !contentType.startsWith("image/")) {return Result.error("请上传图片格式的文件");}studentService.submit(examCard, screenShot);return Result.success("准考号为"+examCard+"的学生提交答题截图成功");} catch (Exception e) {log.error("提交答题截图失败", e);return Result.error("提交答题截图失败：" + e.getMessage());}
}