解决SpringBoot2.x添加拦截器后Swagger无法访问

最新推荐文章于 2025-07-01 17:32:45 发布

一个技术渣渣

最新推荐文章于 2025-07-01 17:32:45 发布

阅读量4.1k

点赞数

CC 4.0 BY-SA版权

分类专栏： SpringBoot 文章标签：拦截器

本文链接：https://blog.youkuaiyun.com/kevinxxw/article/details/90720177

SpringBoot 专栏收录该内容

7 篇文章

订阅专栏

博客主要介绍Spring Boot拦截器的配置，包括1.x和2.x的配置方式，指出在Spring Boot 2.x中WebMvcConfigurerAdapter已被弃用，更好做法是实现WebMvcConfigurer接口，还提到自定义拦截器。此外，说明了添加拦截器后Swagger无法访问的问题及解决办法，即配置swagger资源路径。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

一、配置拦截器

（1）SpringBoot 1.x配置方式

@Configuration
public class AppConfig extends WebMvcConfigurerAdapter {
	@Resource
	private FRInterceptor fRInterceptor;
 
	@Override
	public void addInterceptors(InterceptorRegistry registry) {
		//自定义拦截器，添加拦截路径和排除拦截路径 
	registry.addInterceptor(fRInterceptor)
            .addPathPatterns("api/**")
            .excludePathPatterns("api/login");
}

（2）SpringBoot 2.x配置方式

但是在spring boot2.x中，WebMvcConfigurerAdapter被deprecated，虽然继承WebMvcConfigurerAdapter这个类虽然有此便利，但在Spring5.0里面已经deprecated了。

　官方文档也说了，WebMvcConfigurer接口现在已经有了默认的空白方法，所以在Springboot2.0（Spring5.0）下更好的做法还是implements WebMvcConfigurer。

@Configuration
public class WebConfig implements WebMvcConfigurer {
	@Resource
	private FileUploadInterceptor fileUploadInterceptor;
 
	@Override
	public void addInterceptors(InterceptorRegistry registry) {
		// 自定义拦截器，添加拦截路径和排除拦截路径
		registry.addInterceptor(fileUploadInterceptor).addPathPatterns("/**");
	}
}

（3）自定义拦截器

@Component
public class FileUploadInterceptor implements HandlerInterceptor {
	/*
	 * 视图渲染之后的操作
	 */
	@Override
	public void afterCompletion(HttpServletRequest arg0, HttpServletResponse arg1, Object arg2, Exception arg3)
			throws Exception {
 
	}
 
	/*
	 * 处理请求完成后视图渲染之前的处理操作
	 */
	@Override
	public void postHandle(HttpServletRequest arg0, HttpServletResponse arg1, Object arg2, ModelAndView arg3)
			throws Exception {
 
	}
 
	/*
	 * 进入controller层之前拦截请求
	 */
	@Override
	public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object obj) throws Exception {
		System.out.println("getContextPath:" + request.getContextPath());
		System.out.println("getServletPath:" + request.getServletPath());
		System.out.println("getRequestURI:" + request.getRequestURI());
		System.out.println("getRequestURL:" + request.getRequestURL());
		System.out.println("getRealPath:" + request.getSession().getServletContext().getRealPath("image"));
		return true;
	}
 
}

二、添加拦截器后Swagger无法访问

在配置拦截器的时候，配置swagger资源路径

@Configuration
public class InteceptorConfig implements WebMvcConfigurer {
    @Autowired
    EnvironmentConfig environmentConfig;
    @Resource
    private AccessCheckInteceptor accessCheckInteceptor;

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        // 自定义拦截器，添加拦截路径和排除拦截路径
        String excludePathStr = environmentConfig.getConfigEnvironment();
        String[] excludePathArr = excludePathStr.split(",");
        registry.addInterceptor(accessCheckInteceptor)
                // 排除配置
                .excludePathPatterns(excludePathArr)
                // 拦截配置
                .addPathPatterns("/**");
    }

    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/static/**").addResourceLocations("classpath:/static/");
        registry.addResourceHandler("/templates/**").addResourceLocations("classpath:/templates/");
        // 放行swagger
        registry.addResourceHandler("swagger-ui.html").addResourceLocations("classpath:/META-INF/resources/");
        registry.addResourceHandler("/webjars/**").addResourceLocations("classpath:/META-INF/resources/webjars/");
    }
}