SpringBoot部署项目到Linux上传文件路径问题

最新推荐文章于 2025-05-16 09:24:21 发布

原创最新推荐文章于 2025-05-16 09:24:21 发布 · 8.2k 阅读

33 ·

CC 4.0 BY-SA版权

文章标签：

#java #spring

本文解决SpringBoot项目在Linux服务器上部署时的文件上传路径问题，通过配置映射服务器URL到本地绝对路径，确保图片等静态资源能正确上传并被访问。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

SpringBoot部署项目到Linux上传文件路径问题

使用项目相对路径上传到话会上传到linux服务器到/tmp 临时文件目录中，但是问题是还会报异常

Caused by: java.io.FileNotFoundException: /tmp/tomcat.8223985333111777969.80/work/Tomcat/localhost/ROOT/file:/project/myblog-0.0.1-SNAPSHOT.jar!/BOOT-INF/classes!/static/img/User/v2-3e1d742d3d2a98cbf122b3414ceb29e7_720w.jpg (No such file or directory)

如上述到异常。

解决办法

使用绝对路径

1、但是我们知道服务器访问时是访问服务器url ，所以我们要用url映射到绝对路径中。

package com.Config;


import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurationSupport;

@Configuration
public class WebMvcConfig extends WebMvcConfigurationSupport {


    @Value("${file.staticAccessPath}")
    private String staticAccessPath;

    @Value("${file.uploadFolder}")
    private String uploadFolder;

    @Override
    protected void addResourceHandlers(ResourceHandlerRegistry registry) {
       registry.addResourceHandler("/img/**").addResourceLocations("classpath:/static/img/");
       registry.addResourceHandler("/css/**").addResourceLocations("classpath:/static/css/");
       registry.addResourceHandler("/js/**").addResourceLocations("classpath:/static/js/");
       registry.addResourceHandler("/editor.md-master/**").addResourceLocations("classpath:/static/editor.md-master/");

       // 配置 服务器上的地址 localhost:8080/Users/zlf/myBlog/upload/ 映射到本地linux/Mac  /Users/zlf/myBlog/upload/ (需要在前面加 file:)
       registry.addResourceHandler(staticAccessPath+"**").addResourceLocations("file:"+uploadFolder);
       super.addResourceHandlers(registry);


    }
}

附加上上传文件配置

package com.Config;


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 org.springframework.util.unit.DataSize;

import javax.servlet.MultipartConfigElement;

@Configuration
public class UploadFileConfig {


    @Value("${file.uploadFolder}")
    private String uploadFolder;

    @Bean
    public MultipartConfigElement multipartConfigElement() {
        MultipartConfigFactory factory = new MultipartConfigFactory();
        factory.setLocation(uploadFolder);
        //文件最大
        factory.setMaxFileSize(DataSize.parse("5MB"));
        // 设置总上传数据总大小
        factory.setMaxRequestSize(DataSize.parse("10MB"));
        return factory.createMultipartConfig();
    }
}

application.yaml

file:
  # 服务器上的地址 localhost:8080/Users/zlf/myBlog/upload
  staticAccessPath: /Users/zlf/myBlog/upload/
  # 本地路径 /Users/zlf/myBlog/upload
  uploadFolder: /Users/zlf/myBlog/upload/

这样我们存储图片文件时就存储在linux的绝对路径就行，访问服务器时服务器会自动映射。