spring boot文件上传、undertow 临时文件配置、NoSuchFileException: /tmp/under、IOException: No space left on device

前言

基本环境版本：

spring boot：2.4.5

undertow：2.5.7

通过spring boot MultipartFile上传文件时，spring boot默认配置会在/tmp下创建undertow的目录，来存放中途临时上传的文件，当上传完成后将/tmp中的文件清理，但在实际工作中，一台服务器的/tmp往往很小，且一台服务器上搭载了很多应用就很容易出现磁盘空间不足的情况，例如：

Failed to parse multipart servlet request; nested exception is java.lang.RuntimeException: java.io.IOException: No space left on device

又或者

NoSuchFileException: /tmp/undertow 

问题原因

        undertow服务会自动在/tmp下载创建一个临时文件夹，用于文件上传、。

        当对于linux而言/tmp目录时一个临时目录，很多应用程序的临时运行目录都可能使用到/tmp，一台服务器的/tmp磁盘空间有限，当满了以后spring就会报IOException: No space left on device的异常。

        linux会自动清理10天前的/tmp下目录文件（不同操作系统默认配置可以不一样），又或者被其他用户清理了，就会造成上面NoSuchFileException文件夹找不到的错误。。

解决方案概述

        要解决上述问题就有几种途径：

1. 加大/tmp挂载磁盘的大小
2. 防止/tmp/undertow*被清理
3. 修改上传文件使用的临时目录

这里我主要阐述和讨论如何修改上传文件所使用的临时目录，因为这个途径是最安全便捷的，通过制定文件上传临时文件夹的路径，这样系统就不会自动删除了。

通过网络找到的解决方案

方案一 添加jvm配置

-java.tmp.dir=/data/upload_tmp

方案二 添加jvm配置

-Djava.io.dir=/data/upload_tmp

方案三 添加spring boot配置

spring.servlet.multipart.location=/data/upload_tmp

方案四 使用配置类配置

@Bean
public MultipartConfigElement multipartConfigElement() {
    MultipartConfigFactory factory = new MultipartConfigFactory();
    factory.setLocation(System.getProperty("/data/upload_tmp"));
    return factory.createMultipartConfig();
}

方案五 修改linux清理策略

# 修改系统配置，排除该临时目录
vim /usr/lib/tmpfiles.d/tmp.con
# 文件最后添加
x /tmp/undertow*

总结

经过个人测试，上述方案一至四直接使用都无法修改上传文件文件的临时目录，但参考上述方案，通过以下配置可以实现临时目录的修改：

1、补充spirng boot

spring.servlet.multipart.location=/data/tmp

2、补充配置类

@Configuration
public class MultipartConfig {

    @Value("${spring.servlet.multipart.location}")
    private String tmpLocation;

    @Bean
    public MultipartConfigElement multipartConfigElement() {
        MultipartConfigFactory factory = new MultipartConfigFactory();
        // 若没有该目录，则创建，此处使用了第三方插件的FileUtil，各位可以使用原生File实现该逻辑
        if (!FileUtil.exist(tmpLocation)) {
            FileUtil.mkdir(tmpLocation);
        }
        factory.setLocation(tmpLocation);
        return factory.createMultipartConfig();
    }
}

通过上述两项配置可以实现spring boot 使用undertow容器上传文件时将/tmp/undertow*的临时目录切换至指定的目录下的效果。

但是，依然会在/tmp目录创建一个4k大小的undertow*的目录，不过上传时产生的临时目录不会再存放到/tmp/undertow*下了（可以在上传文件时实时观察/tmp/undertow*和/data/tmp的目录大小判断，上传途中/tmp/undertow*目录无任何变化，而/data/tmp目录一直在变大，当上传完成后/data/tmp大小恢复至0，说明被清理了）

如果各位有其他见解，欢迎评论区留言讨论

参考文章

Linux下 Spring Boot 上传找不到临时目录, 出现500错误 - 灰信网（软件开发博客聚合） (freesion.com)