Failed to parse multipart servlet request ; nested exception is java . io IOException : org . apache . tomcat util . http . file upload . impl . IOFileUploadException : Processing of multipart / form - data request failed . No space left on device

### Tomcat 处理 multipart/form-data 请求失败的解决方案 当遇到 `Failed to parse multipart servlet request` 错误并提示 `No space left on device` 时，这通常表明服务器上的磁盘空间已耗尽。以下是针对此问题的具体分析和解决方案。 #### 1. **原因分析** 错误的核心在于 Tomcat 的临时上传路径 `/tmp/tomcat.<random>.<port>/work/Tomcat/localhost/<context>` 中存储了大量临时文件，而这些文件可能未被及时清理，最终导致磁盘空间不足[^1]。此外，在某些情况下，操作系统可能会定期清理 `/tmp` 文件夹中的内容，从而引发类似的异常。 --- #### 2. **解决方法** ##### 方法一：调整临时目录配置 通过修改 Spring Boot 或 Tomcat 的配置来指定自定义的临时目录位置，而不是依赖默认的 `/tmp` 路径。具体实现如下： - **Windows 环境下的配置** 修改 `application.properties` 或 `application.yml` 文件： ```yaml server.port: 8120 file.baseDir: D:\\xx\\pp\\rr\\re ``` - **Linux 环境下的配置** 同样在 `application.properties` 或 `application.yml` 文件中添加以下内容： ```yaml server.port: 8120 file.baseDir: /home/zzz/ttt/tmp/ ``` 随后创建一个 Bean 来动态设置多部分文件解析器的位置以及最大大小限制： ```java @Component public class CustomMultipartConfig { @Value("${file.baseDir}") private String dirPath; @Bean public MultipartConfigElement multipartConfigElement() { File tempDirectory = new File(dirPath); // 如果目标目录不存在，则尝试创建它 if (!tempDirectory.exists()) { boolean created = tempDirectory.mkdirs(); if (created && !tempDirectory.setWritable(true, false)) { throw new RuntimeException("无法赋予目录写入权限！"); } } MultipartConfigFactory factory = new MultipartConfigFactory(); factory.setLocation(tempDirectory.getAbsolutePath()); factory.setMaxFileSize("128MB"); factory.setMaxRequestSize("128MB"); return factory.createMultipartConfig(); } } ``` 上述代码片段会确保即使磁盘空间有限的情况下也能合理分配资源，并减少因临时文件堆积而导致的空间占用问题[^2]。 --- ##### 方法二：监控与优化磁盘使用情况 除了更改临时目录外，还需要关注整个系统的磁盘健康状况。可以采取以下措施预防此类事件再次发生： - 定期检查硬盘剩余容量； - 设置定时任务自动清除旧的日志或其他不必要的数据； - 使用专门工具（如 Linux 下的 `du`, `df` 命令）定位大体积文件或冗余项。 例如，在 Linux 上可以通过执行命令查看当前分区状态： ```bash df -hT ``` 如果发现某个特定区域接近满载，则需进一步排查其内部结构分布详情： ```bash du -sh * ``` --- ##### 方法三：扩展物理存储能力 对于生产环境而言，单纯依靠软件层面的操作或许不足以彻底解决问题。因此建议考虑增加硬件支持——比如挂载额外的外部驱动器或者升级到更大规格的固态硬盘(SSD)，以此从根本上缓解压力。 --- ### 总结 综上所述，面对由于磁盘空间不足引起的 `Failed to parse multipart servlet request` 报错现象，可以从重新规划工作区位址、强化日常运维管理两方面入手加以应对。同时也要注意长远规划基础设施建设，避免类似瓶颈制约业务发展进程。