spring boot 2.0 + 静态资源被拦截,怎么办?

问题描述:使用springboot 2.0后,按照springboot 1.5版本(以下简称旧版)的方式去配置项目。结果发现静态资源访问不到了,本文对此情况分析、处理

项目结构:

  • 直接上图

如果是在旧版,需要访问下图静态资源,

地址应该为: localhost:8080/admin/js/base.js
原因在于:META-INF/resources / resources / static / public 都是spring boot 认为静态资源应该放置的位置,会自动去寻找静态资源

然而,在2.0之后 就发生了变化。

先看本文的基础,拦截器

BaseInterceptor

  • 毫无疑问,需要定义一个类:BaseInterceptor 应实现 HandlerInterceptor

  • 在其 preHandle中 需要重写,自定义拦截配置,大概如下图:

  • 作用:拦截没有登录,并试图知己访问后台的地址的操作。

再看本文的关键,WebMvcConfig

  • 此类需要实现 WebMvcConfigurer

  • 在旧版中,一般继承 WebMvcConfigurerAdapter类,但由于2.0后,WebMvcConfigurer 接口中定义了很多default方法(基于jdk1.8+ )

  • WebMvcConfigurer中配置如下:

  • 注意:需要在重写的第二个方法中,添加静态资源路径,这是能否被识别的关键

@Component
public class WebMvcConfig implements WebMvcConfigurer {
    @Resource
    private BaseInterceptor baseInterceptor;
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(baseInterceptor)
                //需要配置2:----------- 告知拦截器:/static/admin/** 与 /static/user/** 不需要拦截 (配置的是 路径)
                .excludePathPatterns("/static/admin/**", "/static/user/**");
    }

    /**
     * 添加静态资源文件,外部可以直接访问地址
     * @param registry
     */
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        //其他静态资源,与本文关系不大
        registry.addResourceHandler("/upload/**").addResourceLocations("file:"+ TaleUtils.getUplodFilePath()+"upload/");

        //需要配置1:----------- 需要告知系统,这是要被当成静态文件的!
        //第一个方法设置访问路径前缀,第二个方法设置资源路径
        registry.addResourceHandler("/static/**").addResourceLocations("classpath:/static/");
    }

    @Override
    public void addViewControllers(ViewControllerRegistry registry) {
        //registry.addViewController("/error/404").setViewName("/admin/page_error/error_404.html");
    }
}

按照如上配置

  • 访问:http://localhost:9090/static/admin/js/base.js,即可正常访问到。
  • 也就是在html文件中,不要像之前一样,/admin/js/base.js 而应该在前方加上addResourceHandlers中配置的名字

之前谁在拦截静态资源?

  • 可以在aseInterceptor 中的 preHandle() 方法体内打断点,会发现访问static下的静态资源时候会进入此方法。
  • 也就是被其当做正常的访问路径去识别。导致无法正常加载。
  • 换句话说,也就是配置的不完整,导致静态资源没有被识别。

还可以参考

https://my.oschina.net/dengfuwei/blog/1795346

  • WebMvcConfig addInterceptors方法中,添加排除路径;
  • 但是尴尬的是,我copy的项目结构不太一样,static/template下方都有 admin文件夹,并且登录访问还是admin开始
  • 如果排除静态资源的话,那些需要跳转的html也被排除了 。

18-5-23日更新

  • 原文中的配置还是有问题!
  • 还是应该在 WebMvcConfig 中的 addInterceptors 排除路径,原来虽然能访问到静态资源,但是还是被拦截器中的 preHandle拦截!
  • 所以还是应该配置排除拦截的路径,上方 WebMvcConfig类中内容已更改~

18-7-31日更新

  • 仅供参考。等搞清楚再来更新。
作者:kangkaii
如果您觉得本文有帮助的话,可以点个推荐呐!! 若有不对或者不合理的地方也欢迎指出,感谢~
本文版权归作者和博客园共有,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接,否则保留追究法律责任的权利.
posted @ 2018-05-11 14:01  kangkaii  阅读(51288)  评论(6编辑  收藏  举报