静态资源解析失效处理"/>
springboot静态资源解析失效处理
文章目录
- 问题1:继承WebMvcConfigurationSupport导致默认配置失效
- 分析
- 解决
- 方式1:WebMvcConfigurationSupport补充静态资源【不推荐】
- 方式2:改写mvc自定义配置实现【推荐】
- 总结
- 问题2: 前端页面访问static下资源404
- 问题3: springmvc访问webjars下资源404
问题1:继承WebMvcConfigurationSupport导致默认配置失效
我们开发了一个基于SpringBoot的工具(starter封装),可以提供通用的功能和管理页面。为了让这些页面能够在不同的SpringBoot项目中使用,我们采用了一种叫做webjars的技术,将页面的静态资源(如JavaScript和CSS文件)存放在一个公共的地方。但是有些项目访问这些资源时可能会遇到404错误的问题,无法正常显示页面。
分析
首先springboot默认提供包括static webjars的资源解析的。这个是默认的mvc配置提供。因此检查出现404的项目的所有mvc配置是否有被调整。
发现该项目存在跨域配置. 是通过WebMvcConfigurationSupport继承实现
@Configuration
public class AppConfig extends WebMvcConfigurationSupport {/*** 统一处理跨域问题*/@Overridepublic void addCorsMappings(CorsRegistry registry) {registry.addMapping("/**").allowedOrigins("*").allowedMethods("GET", "POST", "DELETE", "PUT").allowCredentials(true).maxAge(3600);}
}
- 结论: 通过WebMvcConfigurationSupport继承实现会导致默认mvc配置失效。
- 原因: 看如下源码
解决
方式1:WebMvcConfigurationSupport补充静态资源【不推荐】
静态资源解析失效,因为是覆盖默认mvc配置,那么。直接补充就好
@Configuration
public class AppConfig extends WebMvcConfigurationSupport {/*** 统一处理跨域问题*/@Overridepublic void addCorsMappings(CorsRegistry registry) {registry.addMapping("/**").allowedOrigins("*").allowedMethods("GET", "POST", "DELETE", "PUT").allowCredentials(true).maxAge(3600);}@Overridepublic void addResourceHandlers(ResourceHandlerRegistry registry) {// 解决静态资源无法访问的问题registry.addResourceHandler("/**").addResourceLocations("classpath:/static/");registry.addResourceHandler("/doc.html").addResourceLocations("classpath:/META-INF/resources/");registry.addResourceHandler("/webjars/**").addResourceLocations("classpath:/META-INF/resources/webjars/");}
}
虽然能解决问题,WebMvcConfigurationSupport但是这种方式不太好,以后还有可能其他默认行为被覆盖,还得补。
方式2:改写mvc自定义配置实现【推荐】
实现WebMvcConfigurer接口,只会覆盖实现接口逻辑。springboot默认的mvc配置不会被改变
@Configuration
public class WebMvcConfig implements WebMvcConfigurer {/** 跨域支持*/@Overridepublic void addCorsMappings(CorsRegistry registry) {registry.addMapping("/**").allowedOrigins("*").allowedMethods("POST", "GET", "PUT", "OPTIONS", "DELETE").allowCredentials(true).allowedHeaders("*").maxAge(3600);}
}
总结
springboot项目中想要调整mvc配置.尽量通过实现WebMvcConfigurer 接口实现。直接继承WebMvcConfigurationSupport会,导致默认处理失效。
问题2: 前端页面访问static下资源404
Spring Boot 支持访问位于 static 目录下的静态资源,例如 CSS 和 JavaScript 文件。
默认情况下,Spring Boot 会将 static 目录作为静态资源的根目录。这意味着你可以将静态资源文件(如 CSS 和 JavaScript 文件)放置在 static 目录下的任何子目录中,并通过相对路径进行访问
后端资源目录
└── src└── main└── resources└── static├── css│ └── styles.css└── js└── script.js
前端访问
<!DOCTYPE html>
<html>
<head><link rel="stylesheet" type="text/css" href="/css/styles.css"><script src="/js/script.js"></script>
</head>
<body><!-- 页面内容 -->
</body>
</html>
注意“/css/styles.css” 前面不要再加static
问题3: springmvc访问webjars下资源404
背景: 开发一个starter服务兼容让springmvc项目使用,自定义WebMvcConfigurer 配置类可以设置静态资源访问
@Configuration
@Import({EasyLogWebAutoConfiguration.class})
public class EasyLogMvcConfig implements WebMvcConfigurer {/**等效于springmvc.xml 添加<mvc:default-servlet-handler/> //可访问前端静态资源*/@Overridepublic void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer) {configurer.enable();}}
easy-log-mvc.xml
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns:xsi=""xmlns:context=""xmlns:mvc=""xmlns:aop="" xmlns=""xsi:schemaLocation=" .0.xsd .0.xsd .0.xsd .xsd"><description>easy-log Spring MVC Configuration</description><bean class="com.zoe.easylog.web.mvc.EasyLogMvcConfig"></bean>
</beans>
接入项目导入配置文件即可
<import resource="classpath*:easy-log-mvc.xml"/>
但是会出现有些springmvc生效有些项目会不生效。还是只能通过xml定义
easy-log-mvc.xml 补充
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns:xsi=""xmlns:context=""xmlns:mvc=""xmlns:aop="" xmlns=""xsi:schemaLocation=" .0.xsd .0.xsd .0.xsd .xsd"><description>easy-log Spring MVC Configuration</description><bean class="com.zoe.easylog.web.mvc.EasyLogMvcConfig"></bean><!--开启静态资源访问--><mvc:default-servlet-handler/>
</beans>
更多推荐
springboot静态资源解析失效处理
发布评论