spring boot 默认可直接通过 /css/style.css 访问 static/css/style.css，无需额外配置；常见阻断点包括路径错误、ide未拷贝资源、误用 @enablewebmvc、自定义 webmvcconfigurer 未调用父类方法，以及错误配置 spring.mvc.static-path-pattern。
Spring Boot 默认就能直接用 /static 下的 CSS，根本不需要额外配置资源映射路径——只要放对位置、没关自动配置、IDE 正常构建，/css/style.css 就能通过 http://localhost:8080/css/style.css 访问。
为什么 /static/css/style.css 无法通过 /css/style.css 访问
这不是 Spring Boot “不认 static”，而是常见几类实际阻断点：
- 文件物理路径不对：比如把
style.css放在了src/main/resources/css/（漏了static），或放在src/main/java下 - IDE 没触发资源拷贝：IntelliJ 默认不自动编译 resources 目录，需勾选 “Build project automatically”，或手动执行
Maven → Resources → copy-resources - 误加了
@EnableWebMvc：这个注解会彻底关闭 Spring Boot 的静态资源自动配置，包括所有默认路径和/**映射逻辑 - 自定义了
WebMvcConfigurer却没调用super.addResourceHandlers(registry)：导致默认的四个静态路径注册被覆盖掉
spring.mvc.static-path-pattern 是干啥的？别乱配
这个配置不是用来“让 static 目录生效”的，而是给所有静态资源 URL **加统一前缀**。比如设成 /res/**，那原本 /css/style.css 就必须改成 /res/css/style.css 才能访问。
常见误用场景：
- 以为加了
spring.mvc.static-path-pattern=/static/**就能用/static/css/style.css访问 —— 实际上这反而会让/css/style.css失效，且/static/**这个路径本身并不对应磁盘上的static文件夹 - 在 Thymeleaf 中写
<link href="/static/css/style.css">—— 错，应该写<link href="/css/style.css">（因为/static/是 classpath 路径，不是 URL 路径）
什么时候才真需要改 static-locations
只有两类情况值得动这个配置：
- 你想把静态资源从
classpath:/static换到别的 classpath 目录下，比如classpath:/assets/，那就配spring.web.resources.static-locations=classpath:/assets/ - 你要接入外部磁盘路径（如用户上传的图片），比如
file:/data/uploads/，并希望它能被 HTTP 直接访问，那就配成spring.web.resources.static-locations=classpath:/static/,file:/data/uploads/
注意：spring.resources.static-locations 在较新版本（2.6+）已弃用，应使用 spring.web.resources.static-locations。
验证是否真的生效，就看这一条 URL
别猜、别翻配置、别查日志——直接浏览器打开：
http://localhost:8080/css/style.css
如果返回 200 和 CSS 内容，说明一切正常；如果 404，再回头检查上面四点。最容易被忽略的是：Maven 构建后 target/classes/static/ 下有没有这个文件，没有就说明 IDE 或 Maven 根本没把 resources 目录复制进去。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
