Spring 2.2升级至2.7后CSS无法加载问题求助

1. 路径匹配策略变更（核心排查点） #

Spring Boot 2.6+ 默认禁用了ant-path-matcher，改用path-pattern-matcher，这会直接影响静态资源的路径匹配规则。如果你的CSS引用路径包含**这类Ant风格通配符，或是配置了自定义静态资源路径，大概率会因此失效。

• 快速验证：在application.properties中添加以下配置，临时切回旧匹配器测试

  spring.mvc.pathmatch.matching-strategy=ant_path_matcher
  

  如果CSS恢复加载，说明是匹配策略问题，需要调整静态资源路径配置或页面引用路径。

2. 静态资源引用路径检查 #

Spring Boot 2.7的默认静态资源位置依然是classpath:/META-INF/resources/、classpath:/resources/、classpath:/static/、classpath:/public/，从你的目录结构看static/css是符合规则的，但要确认页面引用逻辑：

• 模板引擎（如Thymeleaf）必须使用绝对路径引用：

  错误示例：./css/xxx.css（相对路径会因请求URL层级导致404）
  正确示例：<link rel="stylesheet" th:href="@{/css/main.css}">

• 纯HTML页面需确保引用路径以/开头：<link rel="stylesheet" href="/css/main.css">

3. 缓存与资源版本问题 #

升级后可能存在浏览器缓存旧资源路径，或是资源版本管理配置冲突：

• 用Ctrl+F5强制刷新浏览器，清理缓存后重试
• 若开启了资源内容哈希（spring.web.resources.chain.strategy.content.enabled=true），需确保页面引用路径包含哈希值，或临时关闭该配置测试：

  spring.web.resources.chain.strategy.content.enabled=false
  

4. Spring Security拦截静态资源 #

如果项目使用Spring Security，升级后默认拦截规则可能覆盖了静态资源请求，需在Security配置类中添加放行逻辑：

@Override
protected void configure(HttpSecurity http) throws Exception {
    http.authorizeRequests()
        .mvcMatchers("/css/**", "/js/**", "/images/**").permitAll() // 放行静态资源
        .anyRequest().authenticated();
}

注意：若使用path-pattern-matcher匹配策略，必须用mvcMatchers替代antMatchers

5. 目录结构隐性问题 #

即使目录结构未手动修改，也需确认：

• static目录是否严格在src/main/resources下（而非src/main/java或其他目录）
• 文件名是否存在大小写不一致（Linux环境区分大小写，Windows不区分，部署到Linux时可能触发问题）

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