Tomcat 8.5.41多部件请求解析失败问题排查求助

问题背景 #

所有向Tomcat发起的上传请求均返回500内部错误，重启Tomcat后恢复正常。报错提示磁盘空间不足，但实际磁盘剩余空间充足，且应用未生成日志。环境：Tomcat 8.5.41；UI应用基于Spring Boot + Vaadin 14。

报错日志（翻译后） #

org.springframework.web.multipart.MultipartException: 解析multipart servlet请求失败；嵌套异常为java.io.IOException: org.apache.tomcat.util.http.fileupload.FileUploadBase$IOFileUploadException: 处理multipart/form-data请求失败。D:\Automator\install\apache\apache-tomcat-8.5.41\work\Catalina\localhost\automator-ui\upload_61b77b79_c760_41e1_81fb_495567fa24cb_00005763.tmp (磁盘空间不足)

排查方向 #

• 临时目录权限问题：检查Tomcat生成临时文件的路径D:\Automator\install\apache\apache-tomcat-8.5.41\work\Catalina\localhost\automator-ui的读写权限，确保Tomcat运行用户拥有完全控制权限。权限不足会导致文件写入失败，系统误报磁盘空间不足。
• 临时文件/句柄泄漏：上传产生的临时文件未被自动清理，或Tomcat未释放文件句柄，导致inode/句柄数耗尽（非实际磁盘空间不足）。重启Tomcat会清理这些资源，因此恢复正常。可通过配置Tomcat的maxFileSize、maxRequestSize限制上传大小，或设置自动清理临时目录的策略，定期清理work目录下的临时文件。
• Spring Boot Multipart配置冲突：检查Spring Boot配置文件（application.properties/application.yml）中的spring.servlet.multipart.*参数，比如spring.servlet.multipart.location是否指定了合法、有充足空间的临时目录，避免依赖Tomcat默认的work目录。
• 磁盘配额限制：确认Tomcat运行用户是否被设置了磁盘配额，即使总磁盘空间充足，用户配额耗尽也会触发空间不足报错。
• Tomcat版本bug：Tomcat 8.5.41存在multipart上传相关的已知bug，可能导致临时文件处理异常。建议升级到Tomcat 8.5.x最新稳定版或切换至Tomcat 9.x。
• 应用日志生成失败排查：检查应用日志框架配置（如logback.xml、log4j2.xml），确保日志输出目录存在且Tomcat运行用户有写入权限，排查配置错误导致的日志无法生成问题。

内容的提问来源于stack exchange，提问作者Joel Padamadan