java

关注公众号 jb51net

关闭
首页 > 软件编程 > java > SpringBoot 静态资源访问配置

SpringBoot 静态资源访问(图片/JS/CSS)配置详解(最新推荐)

作者：希望永不加班

本文主要讲述了SpringBoot静态资源的默认规则、自定义配置、本地映射、外部路径、权限放行、打包部署等内容,重点介绍了SpringBoot对静态资源的自动映射以及如何解决图片上传成功但访问404、JS/CSS加载失败等问题,感兴趣的朋友跟随小编一起看看吧

在 SpringBoot 项目开发中，静态资源访问是前端页面、图片上传、富文本、后台管理系统必备的功能。
很多同学经常遇到：图片上传成功但访问 404、JS/CSS 加载失败、自定义目录不生效、线上环境无法访问等问题。

今天就来讲讲 SpringBoot 静态资源的默认规则、自定义配置、本地映射、外部路径、权限放行、打包部署。

一、什么是静态资源？

SpringBoot 对这些资源提供自动映射，也支持高度自定义。

二、SpringBoot 默认静态资源规则（自动生效）

默认 5 个静态资源路径（优先级从高到低）：

默认访问规则：
直接访问资源名即可，不需要加目录前缀。

示例：

src/main/resources/static/images/logo.png

访问地址：

http://localhost:8080/images/logo.png

三、最常用场景：自定义静态资源映射

实际项目中，我们会把用户上传的图片/文件存放在服务器外部路径，避免项目重新打包文件丢失。

这时候必须用：SpringMVC 资源映射

1. 编写配置类

package com.demo.config;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
/**
 * 静态资源配置
 */
@Configuration
public class WebMvcConfig implements WebMvcConfigurer {
    /**
     * 静态资源映射
     * 访问路径 /uploads/xxx.jpg  →  映射到本地 D:/uploads/xxx.jpg
     */
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        // 1. 访问 URL 规则
        registry.addResourceHandler("/uploads/**")
                // 2. 本地真实路径（末尾必须加 /）
                .addResourceLocations("file:D:/uploads/");
        // 2. 也可以配置相对路径
        registry.addResourceHandler("/static/**")
                .addResourceLocations("classpath:/static/");
    }
}

2. 访问示例

本地文件：

D:/uploads/avatar.jpg

访问地址：

http://localhost:8080/uploads/avatar.jpg

四、application.yml 配置静态资源

如果你不想写配置类，可以直接在 yml 中配置：

spring:
  web:
    resources:
      # 自定义静态资源路径
      static-locations: classpath:/static/,classpath:/public/,file:./uploads/

⚠️ 注意：
配置后会覆盖默认路径，不是追加，所以要把需要的路径都写上。

五、静态资源放行（解决 Shiro/Security 拦截 404）

如果项目集成了 Shiro/Spring Security，静态资源会被登录拦截，必须手动放行：

1. Shiro 放行配置

filterMap.put("/static/**", "anon");
filterMap.put("/uploads/**", "anon");
filterMap.put("/**.js", "anon");
filterMap.put("/**.css", "anon");
filterMap.put("/**.png", "anon");
filterMap.put("/**.jpg", "anon");
filterMap.put("/**.ico", "anon");

2. Security 放行配置

http.authorizeRequests()
    .antMatchers("/static/**","/uploads/**","/**.js","/**.css").permitAll()
    .anyRequest().authenticated();

六、自定义 favicon.ico（网站图标）

只需要把 favicon.ico 放到：

resources/static/favicon.ico

SpringBoot 自动加载，无需任何配置。

七、SpringBoot 静态资源缓存（生产优化）

registry.addResourceHandler("/static/**")
        .addResourceLocations("classpath:/static/")
        // 浏览器缓存 10 天
        .setCachePeriod(864000);

八、图片上传 + 回显完整实战

1. 上传接口

@PostMapping("/upload")
public Result upload(MultipartFile file) throws IOException {
    // 上传目录
    String path = "D:/uploads/";
    File dir = new File(path);
    if (!dir.exists()) dir.mkdirs();
    // 文件名
    String fileName = UUID.randomUUID() + file.getOriginalFilename().substring(file.getOriginalFilename().lastIndexOf("."));
    file.transferTo(new File(path + fileName));
    // 返回可访问的 URL
    String url = "http://localhost:8080/uploads/" + fileName;
    return Result.success(url);
}

2. 配置映射

registry.addResourceHandler("/uploads/**")
        .addResourceLocations("file:D:/uploads/");

九、Linux 服务器部署路径写法

registry.addResourceHandler("/uploads/**")
        .addResourceLocations("file:/usr/local/uploads/");

十、静态资源 404 常见原因

十一、SpringBoot 静态资源核心总结

掌握这些，所有静态资源问题全部解决！

 总结与建议

到此这篇关于SpringBoot 静态资源访问(图片/JS/CSS)配置详解(最新推荐)的文章就介绍到这了,更多相关SpringBoot 静态资源访问配置内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:
阅读全文