Failed to parse multipart servlet request； nested exception is java.lang.RuntimeException: java.nio.

最新推荐文章于 2025-11-22 11:30:23 发布

原创最新推荐文章于 2025-11-22 11:30:23 发布 · 2.3w 阅读

27 ·

CC 4.0 BY-SA版权

文章标签：

#java #开发语言 #后端

面试从入门到放弃专栏收录该内容

12 篇文章

订阅专栏

当SpringBoot应用在Linux环境中遇到上传文件报错，原因可能是系统自动清理了临时目录。为了解决这个问题，可以自定义临时文件路径，避免因系统清理导致的NoSuchFileException。在项目配置中添加自定义临时目录，并在启动时检查并创建该目录，确保文件上传的正常进行。通过这种方法，可以确保服务稳定运行，不再受制于系统默认的临时文件清理机制。

生产问题记录日志：上传文件报错

Failed to parse multipart servlet request; nested exception is java.lang.RuntimeException: java.nio.file.NoSuchFileException: /data/tmp/tomcat_upload/undertow4345140605170222984upload

1.造成原因分析：

Failed to parse multipart servlet request; nested exception is java.lang.RuntimeException: java.nio.file.NoSuchFileException: /data/tmp/tomcat_upload/undertow4345140605170222984upload

上传文件的临时路径找不到

2 原因说明
在linux系统中，springboot应用服务再启动（java -jar 命令启动服务）的时候，会在操作系统的/tmp目录下生成一个tomcat*的文件目录，上传的文件先要转换成临时文件保存在这个文件夹下面。

由于临时/tmp目录下的文件，在长时间（10天）没有使用的情况下，就会被系统机制自动删除掉。

3 解决方法自定义配置临时文件路径
在你的项目配置文件中添加自定义配置如下：

项目是微服务，注册中心是nacos,在nacos生成配置文件加一行配置即可

同时需要在服务器上创建对应文件夹保证项目再次上传文件能找到对应文件。

发布nacos,重启服务即可，正常使用！

扩展：

这样需要你手动在你服务器根目录下创建这个文件夹，我们可以在项目启动的时候检查一下临时文件夹是否存在，不存在就创建

import org.springframework.beans.factory.annotation.Value;
import org.springframework.boot.web.servlet.MultipartConfigFactory;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import javax.servlet.MultipartConfigElement;
import java.io.File;

@Configuration
public class MultipartConfig {
    @Value("${location.tempDir:/tmp/tomcat_upload}")
    private String tempDir;

    @Bean
    MultipartConfigElement multipartConfigElement() {
        MultipartConfigFactory factory = new MultipartConfigFactory();
        File tmpDirFile = new File(tempDir);
        // 判断文件夹是否存在
        if (!tmpDirFile.exists()) {
            //创建文件夹
            tmpDirFile.mkdirs();
        }
        factory.setLocation(tempDir);
        return factory.createMultipartConfig();
    }
}