SpringBoot项目通过URL访问本地文件实现方法和遇到的问题

关注

原创最新推荐文章于 2026-04-15 10:25:00 发布 4.6k 阅读 AI 写同款· GEO 优化 ›

SpringBoot 数据访问与操作教程 Spring Boot是一个快速、敏捷的开发框架，可以轻松用于构建单个、微服务架构或整体应用。它的主要优点之一就是在于提供了自动配置特性，Spring Boot可以自动化很多应用设置，比如数据源的配置、日志系统的选择等。另一个重要的特点是其“约定优于配置”的设计理念，使得开发人员不用再重复编写相同的代码。基于这些特点，它在Java社区中受到广泛关注。在实际项目开发中，我们通常需要对数据库进行读、写操作，并根据业务需求增删改查数据。阅读详情

场景

当文件上传到服务器后，需要通过URL去访问服务器相应的文件，可以是图片或其他的文件。

实现

由于SpringBoot本质是嵌入的tomcat，所以并不能够直接从tomcat目录去访问需要的资源，因此需要继承WebMvcConfigurer 去实现自己的拦截器，将用于访问的/show/**去映射本地的文件夹地址
此处要注意路径的尾部一定要加上 " / "，也就是文件分隔符，不然是不能够正确映射到相应的文件夹的
也就是file:D:/Demo/和file:D:/Demo的区别，一定要使用前者才能正确访问

package com.hwh.communitymanage.config;

import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.CorsRegistry;
import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

import java.io.File;

/**
 * @description:
 * @author: HwH
 * @create: 2022-11-24 23:11
 **/
@Configuration
public class WebMvcConfig implements WebMvcConfigurer {

    // 静态资源展示
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        // PS：注意文件路径最后的斜杠（文件分隔符），如果缺少了，就不能够正确的映射到相应的目录
        String basePath = "file:D:/Demo/";
      	registry.addResourceHandler("/show/**").addResourceLocations(basePath);
    }

}