Spring Boot 2.6.0 Web MVC 静态资源配置解析

"该文档详细介绍了Spring框架在2.6.0版本中关于静态资源配置的原理，特别是自动配置的相关机制。文档来源于csdn，并且主要关注Spring Boot的自动配置类`WebMvcAutoConfiguration`及其作用。" 在Spring框架中，静态资源配置是用于处理应用程序中的静态资源，如CSS、JavaScript、图片等非Java代码文件。Spring Boot通过自动配置简化了这一过程，使得开发者无需手动编写大量代码来设置静态资源的路径和访问规则。 首先，`WebMvcAutoConfiguration`类位于`spring-boot-autoconfigure`模块中，它是Spring Boot自动配置的核心组件之一。这个类通过多个注解来控制其生效条件： 1. `@Configuration(proxyBeanMethods=false)`：声明这是一个配置类，同时关闭代理bean方法的生成。 2. `@ConditionalOnWebApplication(type=Type.SERVLET)`：确保只有在Servlet环境下（如Tomcat、Jetty等）才会启用此配置。 3. `@ConditionalOnClass`：检查类是否存在于类路径中，如果存在则配置生效。这里检查了Servlet类和DispatcherServlet类，以及`WebMvcConfigurer`接口。 4. `@ConditionalOnMissingBean(WebMvcConfigurationSupport.class)`：当容器中不存在`WebMvcConfigurationSupport`类型的bean时，此配置才生效，避免与用户自定义的配置冲突。 5. `@AutoConfigureOrder(Ordered.HIGHEST_PRECEDENCE+10)`：设定自动配置的顺序，值越大，配置优先级越高。 6. `@AutoConfigureAfter`：指定在哪些配置类之后进行配置，这里指定了`DispatcherServletAutoConfiguration`、`TaskExecutionAutoConfiguration`和`ValidationAutoConfiguration`。 接着，`WebMvcAutoConfigurationAdapter`类是自动配置的主要实现，它导入了`EnableWebMvcConfiguration`，启用了Web MVC的功能，并从`WebMvcProperties`和`WebProperties`中读取配置属性。`WebMvcProperties`和`WebProperties`分别对应`spring.mvc`和`spring.web`前缀的YAML或properties配置，允许开发者自定义Web MVC和Web应用的配置。 至于静态资源的默认扫描规则，`WebMvcAutoConfiguration`会通过`WebMvcConfigurer`接口的`addResourceHandlers`方法来添加资源处理器。在这个方法中，通常会定义静态资源的路径和映射规则。默认情况下，Spring Boot会自动处理静态资源的请求，允许在`/static/`、`/public/`、`/resources/`或`/META-INF/resources/`这些路径下找到静态文件。 例如，开发者可以通过以下YAML配置来自定义静态资源路径： ```yaml spring: mvc: static-path-pattern: /custom-static/ ``` 这样，所有以`/custom-static/`开头的URL请求都会被解析为静态资源请求。 总结来说，Spring的静态资源配置原理主要涉及自动配置类`WebMvcAutoConfiguration`及其适配器，通过条件注解来控制配置的生效，以及`WebMvcConfigurer`接口来定制静态资源的处理规则。开发者可以通过YAML配置文件轻松调整静态资源的访问路径和策略，实现高度灵活和便捷的管理。