Spring Boot 3.1.1中Thymeleaf无法识别CSS文件问题求助

1. 修正模板中的CSS引用方式 #

确保在Thymeleaf模板里使用Thymeleaf的URL表达式引入CSS，而非普通href：

<link rel="stylesheet" th:href="@{/styles.css}">

• 原因：@{/}会自动适配应用的上下文路径，让Thymeleaf正确解析静态资源路径，避免相对路径在多级路由场景下的加载错误。

2. 确认静态资源配置（自定义配置时） #

Spring Boot 3.x默认自动映射src/main/resources/static下的静态资源，若你自定义了WebMvcConfigurer，需确保未覆盖默认映射规则：

@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/**")
                .addResourceLocations("classpath:/static/");
    }
}

• 未自定义配置可跳过此步骤，默认配置已满足需求。

3. 强制清除浏览器缓存 #

浏览器可能缓存了未加载样式的旧页面，按Ctrl+F5强制刷新，或打开开发者工具（F12），在「网络」选项卡勾选「禁用缓存」后重新加载。

4. 验证CSS文件有效性 #

直接访问http://localhost:8080/styles.css确认文件内容正确，同时通过浏览器开发者工具的「元素」面板，检查目标元素是否匹配CSS选择器、是否存在语法错误导致样式不生效。

内容的提问来源于stack exchange，提问作者maniek