springboot项目静态资源访问404路径问题

最新推荐文章于 2025-09-15 21:17:11 发布
原创 最新推荐文章于 2025-09-15 21:17:11 发布 · 2.3k 阅读 · 1 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#spring #spring boot

本文探讨了Springboot中静态资源的默认路径问题，强调了在添加自定义静态资源目录时不需包含'/static/'前缀。同时，分享了一个模板引擎Freemarker配置引起的404错误案例，指出在打包后由于静态资源路径配置与Springboot默认路径冲突导致的问题，并提供了解决方案——注释或删除冲突的静态资源扫描路径配置。

1.Springboot自身静态资源访问有默认路径！！！

  1. classpath:/META-INF/resoutces/
  2. classpath:/resoutces/
  3. classpath:/static/
  4. classpath:/public/
    我们在前端页面中添加资源的时候一定要注意路径的书写，如果自己建了 static 文件夹就不需要在路径上面写/static了，不然会访问不到资源

2.模板引擎的路径配置注意别和Springboot冲突（遇坑点）！！！

  1. 我在使用模板引擎freemarker的时候，在application.properties配置文件中添加了这样一条静态资源扫描路径。
    在这里插入图片描述
    然后在本地运行时不会出现问题，但将项目打包后就出现了资源访问不到404的情况，这就算springboot默认静态资源访问路径和我模板引擎设置的路径重合了。导致访问不到静态资源
    解决方法:注释掉或删除这条代码 spring.web.resources.static-locations=classpath:/static/
解决 Spring Boot 访问请求出现 404 错误的方法详解
pleaseprintf的博客
07-11 6890
在使用 Spring Boot 开发应用程序时，有时可能会遇到访问请求出现 404 错误的情况，即请求的资源未找到。本文将介绍如何解决 Spring Boot 中访问请求出现 404 错误的问题，帮助你正确配置路由和处理请求。通过本文的介绍，你学习了如何解决 Spring Boot 中访问请求出现 404 错误的问题。你了解了检查请求路径和映射、检查请求方法、检查静态资源路径和检查控制器类的注解等方法。根据实际情况，逐步排查问题并采取相应的措施，以解决访问请求出现 404 错误，并确保请求能够正确处理。
SpringBoot Web 开发访问静态资源(附+详细源码剖析)
sdgfafg_25的博客
09-09 3895
改变静态资源访问前缀，比如我们希望下的请求路径，去请求静态资源，应用场景：静态资源访问前缀和控制器请求路径冲突。我们这里需要用到yaml语法的内容，首先，我们在resources类路径下创建一个名为的文件。spring:mvc:运行测试：被我们改为了我们自己的注意：后面的/**不可以省略。不然无法访问的。Spring Boot 也是支持我们自定义静态资源路径，提高了灵活性。改变默认的静态资源路径，比如：我们自己在类路径下增加 test 目录，作为静态资源路径，并完成测试。
springboot 静态资源(static)无法访问问题404
aogula的博客
11-20 7852
springboot 静态资源(static)无法访问问题404 (如果使用了拦截器)检查配置的拦截器是否对静态资源放行 @Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { // 如果不是映射到方法直接通过,防止静态资源被拦截 if (!(handler instanceof HandlerMe
Spring Boot 项目启动白页/404？这些细节你可能忽略了
最新发布
m0_65592409的博客
09-15 1847
项目中根本没有定义任何 Controller，或者定义了 Controller 但未被 Spring 扫描到。访问的路径未与任何 Controller 中的对应。如果你自定义了错误页面但路径配置错误，可能导致白页或错误覆盖。
springBoot 404 完美解决
09-13
囊括我所碰到和可能碰到的所有404原因，我已经完美解决，传此资源造福后人
【BUG】SpringBoot 静态资源(static)无法访问问题404
金鳞踏雨
09-18 1万+
我们使用Springboot框架编写程序，里面使用到了静态资源，如下图所示的 backend目录 和 front目录，如果不进行配置，那么里面的静态文件将无法访问，会报 404的错误。我们可以通过WebMvcConfiguratiWebonSupport与WebMvcConfigurer 来解决。
SpringBoot项目访问static静态资源报错404及解决办法
qq_56111066的博客
07-20 1890
这意味着你可以将静态资源文件（如 CSS 和 JavaScript 文件）放置在 static 目录下的任何子目录中，并通过相对路径进行访问。因为Spring Boot 支持访问位于 static 目录下的静态资源，如 css 和 js 等文件。所以在默认情况下，Spring Boot 会将 static 目录作为静态资源的根目录。在页面中引入静态资源，无需在路径中填写static。
SpringBoot访问静态资源报404——记录一次调试过程与解决方案
contact97的博客
04-27 1万+
SpringBootWeb项目中，默认的静态资源路径有下列4种： classpath:/META-INF/resources classpath:/resources classpath:/static classpath:/public**
springboot security 静态资源
04-18
因此，理解和配置Spring Security处理静态资源的访问是非常重要的。 首先，Spring Boot在`src/main/resources`目录下存放静态资源，包括`static/`、`public/`或`resources/`等子目录。这些目录下的内容将被自动处理...
SpringBoot静态资源目录访问
08-26
SpringBoot 静态资源目录访问 SpringBoot 框架中，静态资源目录访问是指在 Web 应用程序中访问静态资源文件，如 JavaScript、CSS、图片、字体等文件的方式。静态资源目录访问是 Web 应用程序中不可或缺的一部分，...
springboot如何获取相对路径文件夹下静态资源的方法
08-26
Spring Boot提供了多种方式来访问静态资源，本文将介绍如何在Spring Boot中获取相对路径文件夹下静态资源的方法。 在Spring Boot中，静态资源可以存储在classpath下的静态资源文件夹中，也可以存储在相对路径下的...
【springboot】静态资源访问路径配置
One_castle的博客
01-29 1459
【springboot】静态资源访问路径配置 简介 springboot 默认为我们提供了静态资源处理，使用WebMvcAutoConfiguration中的配置各种属性。 在一般情况下，springboot提供的默认配置方式能够满足需求，如果想要完全控制WebMvc，那么就需要在@Configuration注解的配置类上增加@EnableWebMvc，这样WebMvcConfiguration中的配置就无法生效，所有配置都按照你自定义的进行生效。 但是，通常情况下，我们都是使用springboot的默认配
SpringBoot访问静态资源出现404
Stronger的博客
11-18 8453
SpringBoot访问静态资源出现404 SpringBoot图片路径找不到 WebMvcConfigurer
springboot访问后端静态资源404
王举
04-01 2342
默认情况下，MyBatis 会将实体类的属性名转换为小写，并将驼峰命名法转换为下划线命名法，然后与数据库表的列名进行匹配。是 MyBatis 中的一个注解，用于标识实体类中的属性作为表的主键。在 MyBatis 中，如果您要使用。的属性，那么 MyBatis 默认会将它映射为数据库表中的。2.其次可能你书写的路径不属于默认访问路径。注解来标识主键属性，还需要使用。注解来指定主键的生成方式。的实体类，它有一个名为。
SpringBoot 项目访问静态资源404问题
IamLagrange的博客
08-26 1454
springboot静态资源404
spring-boot 访问静态资源404问题
qq_41882485的博客
11-10 4145
昨天在部署spring boot小工具时出现了一个问题，在我访问spring boot下面静态资源的时候出现404问题，当时也不知道解决方案有那些，因为我以前的项目都是前后端分离项目，部署的前端项目一般都用nginx进行反向代理访问的，这次直接使用spring boot访问该项目下的静态文件属实难顶，各种资料翻阅测试还是找到了解决方案，下面看代码把： 在yml中配置： spring: mvc: static-path-pattern: /static/** resources: st
spring boot 访问static下静态资源404
热门推荐
timeless的博客
06-19 2万+
一开始试了好几个官方的目录static,pullic，发现都访问不到，还特意去配置了spring.mvc.static-path-pattern这些，发现都没用。看网上一些情况是由于配了拦截器，但是我没配置拦截器，所以就纳闷怎么默认的就是访问不到，然后新建了一个空白项目，发现一下子能访问到了，那肯定就是我代码里面有配置影响到springboot默认的机制了。尝试删文件看是哪个文件影响的，......
解决SpringBoot项目无法访问resources的static下静态资源，报错404
baidu_38126306的博客
12-28 3471
解决SpringBoot项目无法访问resources/static下静态资源，报404 1. 报错 在html文件中引入了static下的资源，如下： <link rel="stylesheet" th:href="@{/static/styles.css}" /> <img th:src="@{/static/images/TacoCloud.png}"/> 报错： 2. 解决办法 在配置文件application.properties中添加配置： spring.
解决：springboot访问static 404
m0_67393157的博客
04-12 2029
springboot 遇到不能访问静态资源的情况 首先springboot 是默认访问static的 引用JS CSS 路径不需要带上static 如果8080直接访问静态资源 404 This application has no explicit mapping for /error, so you are seeing this as a fallback. 出现这种错误 访问controller一般是没问题的 是静态资源没有加载到tomcat中 看了其他帖子有说在properties中配置路径的 其
springboot项目的静态图片资源访问404
05-28
<think>好的，我现在需要帮助用户解决Spring Boot项目中静态图片资源访问404的问题。首先，我得回忆一下SpringBoot的静态资源处理机制。记得默认情况下，Spring Boot会在几个固定的目录下查找静态资源，比如classpath下的/static、/public、/resources和/META-INF/resources。用户的问题可能出在图片没有放在这些默认目录里，或者配置有误。接下来，用户提到图片放在resources/static/images下，但访问404。这可能意味着路径配置有问题。首先应该检查文件位置是否正确。比如，是否真的在static/images下，有时候可能放错位置，比如放到了src/main/resources/templates里，这会导致找不到。另外，文件扩展名是否正确，比如图片是.jpg还是.png，访问时是否匹配。然后，可能需要查看application.properties或application.yml中的配置。用户可能自定义了静态资源路径，覆盖了默认设置。比如，如果配置了spring.web.resources.static-locations，而没有包含默认的路径，就会导致默认目录失效。这时候需要确保自定义路径包含classpath:/static/或者其他需要的目录。另外，静态资源的访问路径是否正确。默认情况下，静态资源可以通过根路径加上文件名访问，比如http://localhost:8080/image.jpg。但如果配置了spring.mvc.static-path-pattern，比如改成/res/**，那么访问路径就需要加上/res/，比如http://localhost:8080/res/image.jpg。用户可能没有调整访问路径，导致404。还有可能是缓存问题。有时候浏览器缓存了旧的资源，导致新上传的图片无法加载。这时候可以尝试清除缓存或者使用无痕模式访问。另外，Spring Boot的版本可能有影响。不同版本中配置属性可能会有变化，比如旧版使用spring.resources.static-locations，而新版可能改为spring.web.resources.static-locations。需要确认用户的SpringBoot版本，并检查配置是否正确。还有，文件权限问题。虽然这在开发环境中不太常见，但如果有安全设置阻止了资源访问，也可能导致404。需要检查是否有安全配置拦截了静态资源请求。最后，可能需要检查项目结构是否正确。比如是否是Maven或Gradle项目，资源文件是否被正确打包到target或build目录中。有时候文件虽然在src/main/resources里，但打包时没有包含进去，导致运行时找不到。总结下来，解决步骤应该是：确认文件位置、检查配置是否正确、验证访问路径、处理缓存或版本问题，以及检查项目结构和打包结果。可能还需要参考用户提供的引用内容，比如引用[1]中提到修改static-locations为classpath:/images/，这样默认的static目录就不会被包含，需要手动添加。所以如果用户自定义了路径，需要确保包含必要的目录。同时引用[3]列出了默认的四个路径，用户需要确认图片是否在这些路径下。</think>### Spring Boot静态图片资源404问题解决方案 #### 一、确认基础配置 1. **默认静态资源路径** Spring Boot默认会扫描以下四个目录： $$classpath:/META-INF/resources$$ $$classpath:/resources$$ $$classpath:/static$$ $$classpath:/public$$ 请将图片文件放置在`resources/static/images`目录中（例如：`image.jpg`），访问路径应为：`http://localhost:8080/images/image.jpg`[^3]。 2. **验证文件位置** 检查图片是否位于正确的Maven/Gradle资源目录中（如`src/main/resources/static/images`），而非`src/main/java`或其他目录。 --- #### 二、排查自定义配置问题 1. **检查`application.yaml`配置** 若自定义了静态资源路径，需保留默认路径或手动包含： ```yaml spring: web: resources: static-locations: [classpath:/static/, classpath:/images/] # 保留默认路径 ``` 错误的配置示例（覆盖默认路径导致404）： ```yaml static-locations: [classpath:/custom/] # 需同时包含默认路径 ```[^1] 2. **检查路径映射规则** 若修改了静态资源请求前缀： ```yaml spring: mvc: static-path-pattern: /res/** ``` 访问路径需调整为：`http://localhost:8080/res/images/image.jpg`[^1]。 --- #### 三、常见问题排查 1. **文件命名与扩展名** - 确保文件名无特殊字符（如空格、中文） - 扩展名需与文件实际类型一致（如`.jpg` vs `.jpeg`） 2. **缓存问题** - 使用`Ctrl+F5`强制刷新浏览器 - 通过Postman直接测试URL 3. **安全配置拦截** 检查是否添加了错误的Security配置： ```java @Configuration public class SecurityConfig extends WebSecurityConfigurerAdapter { @Override public void configure(WebSecurity web) { web.ignoring().antMatchers("/images/**"); // 放行图片路径 } } ``` --- #### 四、调试工具辅助验证 1. **查看资源映射日志** 启动时添加调试参数： ```properties logging.level.org.springframework.web=DEBUG ``` 观察控制台输出的静态资源映射路径。 2. **验证打包结果** 检查`target/classes/static`目录中是否包含图片文件，若缺失则需： - Maven项目：执行`mvn clean install` - Gradle项目：执行`gradle clean build` --- #### 五、扩展优化方案 1. **自定义资源处理器** ```java @Configuration public class WebConfig implements WebMvcConfigurer { @Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler("/img/**") .addResourceLocations("classpath:/static/images/"); } } ``` 访问路径：`http://localhost:8080/img/image.jpg` 2. **使用CDN加速** 通过配置`spring.web.resources.chain.strategy.content.enabled=true`启用资源版本控制。 ---
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值