org.springframework.web.multipart.MultipartException: Failed to parse multipart servlet request; nested exception is org.apache.commons.fileupload.FileUploadException: the request was rejected because no multipart boundary was found

这个错误通常是由于请求中缺少multipart boundary导致的。multipart boundary是指在multipart/form-data格式的请求中，用于分隔各个part的标识符。你可以检查一下你的请求头中是否包含了正确的Content-Type和boundary参数。另外，也可以尝试使用其他工具或者库重新构造请求，确保请求中包含了正确的multipart boundary。如果你需要更具体的帮助，可以提供更多的上下文信息，我会尽力帮助你解决问题。

### 3. 配置上传文件数量和大小限制 Spring Boot 默认使用 Tomcat 作为内嵌的 Web 容器，而 Tomcat 对于 multipart 请求中的文件数量和大小有默认限制。如果请求中包含过多文件或总数据量超过限制，将导致 `MultipartException` 异常。 在 Spring Boot 的配置文件 `application.properties` 或 `application.yml` 中，可以通过设置以下参数来调整上传文件的数量和大小上限： ```properties spring.servlet.multipart.enabled=true spring.servlet.multipart.max-file-size=50MB spring.servlet.multipart.max-request-size=100MB ``` 其中： - `max-file-size` 表示单个文件的最大大小； - `max-request-size` 表示整个请求的最大数据量。 这些配置会作用于内嵌的 Tomcat 实例，并影响其对 multipart 数据的解析能力[^2]。 --- ### 3. 使用自定义临时目录避免被系统清理 在 Linux 系统中，Spring Boot 启动时会在 `/tmp` 目录下创建用于处理上传的临时目录（如 `tomcat.*`）。由于某些发行版（如 CentOS 7）默认清理 `/tmp` 下超过 10 天未使用的文件，这可能导致上传过程中所需的临时目录被删除，从而引发 `MultipartException`。 为避免此问题，可以在启动应用时通过 JVM 参数指定一个稳定的临时目录： ```bash java -jar -Djava.io.tmpdir=/data/upload_tmp your_app.jar ``` 这样 Tomcat 将使用 `/data/upload_tmp` 作为临时文件夹，而不是系统的 `/tmp` 目录，从而避免因系统自动清理而导致的异常情况[^2]。 --- ### 3. 检查并确保临时目录存在且可写 Spring Boot 在处理 multipart 请求时，会将上传文件先保存到一个由 Tomcat 创建的临时路径中，例如 `/tmp/tomcat.1428942566812653608.8090/work/Tomcat/localhost/ROOT`。如果该路径不存在或没有写权限，会导致文件无法写入，从而抛出 `MultipartException`。 应确保该临时目录在服务运行期间始终有效，并具有正确的读写权限。若发现该目录缺失，可通过重启服务重新生成，或在启动脚本中显式指定临时目录路径以规避此类问题[^3]。 --- ### 3. 升级 Tomcat 或使用 Apache Commons FileUpload 若当前版本的 Tomcat 存在已知的 multipart 解析缺陷，升级至更高版本（如 Tomcat 10.x）可以提升稳定性和性能。此外，使用 Apache Commons FileUpload 替代默认的 multipart 解析机制也是一种可行方案，它提供了更灵活的控制选项和更强的容错能力。 引入依赖： ```xml <dependency> <groupId>commons-fileupload</groupId> <artifactId>commons-fileupload</artifactId> <version>1.4</version> </dependency> ``` 在控制器中手动解析 multipart 请求： ```java protected void doPost(HttpServletRequest request, HttpServletResponse response) throws IOException, ServletException { if (ServletFileUpload.isMultipartContent(request)) { try { List<FileItem> items = new ServletFileUpload(new DiskFileItemFactory()).parseRequest(request); for (FileItem item : items) { if (!item.isFormField()) { String fileName = new File(item.getName()).getName(); String filePath = "/path/to/upload/folder/" + fileName; File storeFile = new File(filePath); item.write(storeFile); } } } catch (Exception ex) { throw new ServletException("File upload failed", ex); } } } ``` 这种方式绕过了 Spring 内部对 multipart 的自动解析逻辑，适用于需要精细控制上传流程的场景[^1]。 ---