使用Jib容器化的Spring Boot应用无法提供静态内容求助

1. 先查Spring Security的路径匹配规则 #

• 别想当然认为静态资源路径配置对了：如果静态文件在/app/resources/static，Spring Boot默认把它映射到根路径（比如访问/index.html而非/static/index.html），要是你配置的是antMatchers("/static/**").permitAll()，那肯定没用。得改成匹配根路径下的静态资源，比如：

  antMatchers("/", "/index.html", "/css/**", "/js/**", "/img/**").permitAll()
  

• 检查是否有多个SecurityFilterChain：如果存在多个Security配置Bean，要保证处理静态资源的链优先级更高（加@Order(1)标注），不然会被后面的认证链拦截。

2. 验证Jib构建后的静态资源状态 #

• 进容器里看看静态文件是不是真在/app/resources/static下，权限对不对：执行ls -l /app/resources/static，确保index.html存在且有读权限。
• 确认Gradle复制任务和Jib的依赖关系：得让复制静态文件的任务在Jib构建前跑完，比如在Gradle里加jib.dependsOn(copyStaticFiles)，不然Jib打包的时候静态文件还没复制过去，等于白搭。

3. 检查Spring Boot静态资源映射配置 #

• 要是自定义过spring.web.resources.static-locations，得确保里面包含classpath:/static/，比如：

  spring.web.resources.static-locations=classpath:/static/,classpath:/public/
  

• 临时关掉静态资源缓存，避免浏览器缓存旧的认证状态干扰排查：

  spring.web.resources.cache.period=0
  

4. 开调试日志看Security拦截过程 #

• 把Spring Security的日志级别改成DEBUG，看请求到底被哪个过滤器拦了：

  logging.level.org.springframework.security=DEBUG
  

  启动后访问/index.html，看日志里有没有显示这个请求被允许，还是被认证过滤器给截了。另外要注意，别把anyRequest().authenticated()放在静态资源permitAll规则前面，不然全局认证规则会覆盖前面的放行规则。

5. 排查容器启动的上下文路径和路由 #

• 如果Spring Boot设了server.servlet.context-path，访问静态资源得加上这个前缀，比如上下文路径是/api，就得访问/api/index.html，同时Security的路径匹配也要对应调整。
• 确认容器启动时没有额外的代理或者路由在Spring Boot之前拦截请求，导致请求没走到Spring Security的配置里。

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