Spring Boot 2.x 静态资源访问404问题整理记录
一、硬件环境
Windows 11 21H2
二、软件环境
Maven 3.8.1
jdk1.8.0_40
IntelliJ IDEA 2021.3.3
Spring Boot 2.6.7
三、POM配置文件
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd"><modelVersion>4.0.0</modelVersion><parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>2.6.7</version><relativePath/> <!-- lookup parent from repository --></parent><groupId>com.example</groupId><artifactId>demo</artifactId><version>0.0.1-SNAPSHOT</version><name>demo</name><description>Demo project for Spring Boot</description><properties><java.version>1.8</java.version></properties><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter</artifactId></dependency><dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><optional>true</optional></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-test</artifactId><scope>test</scope></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency></dependencies><build><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId><configuration><excludes><exclude><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId></exclude></excludes></configuration></plugin></plugins></build></project>四、Spring Boot 静态资源目录
| 配置 | 资源目录 |
|---|---|
| /static | classpath:/static/ |
| /public | classpath:/public/ |
| /resources | classpath:/resources/ |
| /META-INF/resources | classpath:/META-INF/resources/* |
五、问题
1、打包方式
项目的打包类型分为：pom、jar、war
| 类型 | 作用 |
|---|---|
| pom | 父类型都为pom类型 |
| jar | 内部调用或者是作服务使用 |
| war | 需要部署的项目 |
POM是最简单的打包类型。不像一个JAR，SAR，或者EAR，它生成的构件只是它本身，没有代码需要测试或者编译，也没有资源需要处理，打包类型为POM的项目的默认目标。
| 生命周期阶段 | 目标 |
|---|---|
| package | site:attach-descriptor |
| install | install:install |
| deploy | deploy:deploy |
POM方式打包并没有将静态资源打包，所以无法访问静态资源
<packaging>pom</packaging>
六、场景及解决方案
1、修改配置文件
（1）访问本地静态资源
适用场景：前后端未分离项目或需要访问项目内部html、js、img等静态资源。
spring:mvc:# 访问路径不需要加前缀 http://127.0.0.1:8080/1.jpgstatic-path-pattern: /**web:# 资源目录，多个用逗号分隔resources:static-locations: classpath:/META-INF/resources/,classpath:/resources/,classpath:/static/,classpath:/public/（2）发布本地目录
适用场景：项目中有图片上传、在线浏览等场景，需要挂载并发布本地目录
spring:mvc:# 访问路径需要加前缀 http://127.0.0.1:8080/image/1.jpgstatic-path-pattern: /image/**web:# 资源目录，多个用逗号分隔resources:static-locations: file:C:\SoftWare\Wallpaper
2、实现WebMvcConfigurer
package com.example.demo.config;import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.*;@Configuration
class MyWebMvcConfig implements WebMvcConfigurer {@Overridepublic void addResourceHandlers(ResourceHandlerRegistry registry) {// 加载静态资源，访问路径不需要加前缀 http://127.0.0.1:8080/1.jpgregistry.addResourceHandler("/**").addResourceLocations("classpath:/static/").addResourceLocations("classpath:/public/").addResourceLocations("classpath:/resources/").addResourceLocations("classpath:/META-INF/resources/");// 挂在本地目录，访问路径需要加前缀 http://127.0.0.1:8080/image/1.jpgregistry.addResourceHandler("/image/**").addResourceLocations("file:C:/SoftWare/Wallpaper/");WebMvcConfigurer.super.addResourceHandlers(registry);}
}
参考文献：
- https://blog.csdn.net/qq_41094332/article/details/108497080
- https://blog.csdn.net/syc000666/article/details/105110117
- https://blog.csdn.net/xiaozheng12/article/details/100517099
本文来自互联网用户投稿，文章观点仅代表作者本人，不代表本站立场，不承担相关法律责任。如若转载，请注明出处。 如若内容造成侵权/违法违规/事实不符，请点击【内容举报】进行投诉反馈！