Spring Boot自定义JWT过滤器permitAll失效 无token请求被拦截
排查结论
你遇到的permitAll规则失效问题,核心是自定义过滤器的执行逻辑和执行顺序错位,和Spring Security本身的权限配置规则无关,具体疏漏点和修复方案如下:
核心疏漏点
- 执行顺序天然错位:JWT过滤器配置在
UsernamePasswordAuthenticationFilter之前,这个阶段请求还没有走到Spring Security的权限校验环节(也就是匹配antMatchers、判断permitAll规则的环节),只要你的JWT过滤器主动拦截、抛异常,后面的permitAll规则根本没机会生效。 - token解析逻辑越界:当前
resolveToken的实现是“只要请求没带Bearer格式的token,就直接抛InvalidJwtException”,完全没有给匿名访问留通道。按照设计,JWT过滤器只应该处理“已经带了token”的场景:token合法就填充认证上下文,token不合法就抛异常;如果请求根本没带token,就应该直接放行,把判断“这个路径能不能匿名访问”的逻辑完全交给Spring Security的权限模块处理。 - 过滤器实例创建方式隐患:当前在WebSecurityConfig中直接手动new了一个JwtTokenFilter实例,没有使用Spring容器管理的单例,虽然不是本次问题的核心原因,但会带来依赖失效、行为不一致的潜在问题。
分步修复方案
- 修正
resolveToken的判断逻辑,把“未携带token时抛异常”的分支改为返回null,仅当请求携带了Authorization头但格式不符合要求时,才抛出格式错误的异常:fun resolveToken(req: HttpServletRequest): String? { val bearerToken = req.getHeader(AUTHORIZATION_HEADER) ?: return null return if (bearerToken.startsWith(BEARER)) { bearerToken.substring(7) } else { throw InvalidJwtException("Authorization token must be Bearer [token]", HttpStatus.FORBIDDEN) } } - 调整JwtTokenFilter的处理逻辑:只有当
resolveToken返回非空值时,才做token校验和认证信息填充;如果返回null(请求未携带token),直接放行进入过滤链,让后续的权限校验环节判断当前路径是否允许匿名访问。
修正后的过滤器核心逻辑:override fun doFilterInternal( request: HttpServletRequest, response: HttpServletResponse, filterChain: FilterChain ) { try { val token = jwtTokenProvider.resolveToken(request) if (token != null) { if (jwtTokenProvider.validateToken(token)) { val auth = jwtTokenProvider.getAuthentication(token) SecurityContextHolder.getContext().authentication = auth } else { SecurityContextHolder.clearContext() throw InvalidJwtException("Invalid JWT token", HttpStatus.UNAUTHORIZED) } } } catch (e: InvalidJwtException) { SecurityContextHolder.clearContext() throw e } filterChain.doFilter(request, response) } - 优化WebSecurityConfig的过滤器配置,不要手动创建JwtTokenFilter实例,直接注入容器管理的单例使用,避免依赖失效:
class WebSecurityConfig( private val jwtTokenFilter: JwtTokenFilter, private val filterChainExceptionHandler: FilterChainExceptionHandler, ) : WebSecurityConfigurerAdapter() { override fun configure(http: HttpSecurity?) { http?.csrf()?.disable() http?.sessionManagement()?.sessionCreationPolicy(SessionCreationPolicy.STATELESS) http ?.authorizeRequests() ?.antMatchers("/api/v1/auth/signin")?.permitAll() ?.antMatchers("/api/v1/auth/checkEmailExist")?.permitAll() ?.anyRequest()?.authenticated() http ?.addFilterBefore(jwtTokenFilter, UsernamePasswordAuthenticationFilter::class.java) ?.addFilterBefore(filterChainExceptionHandler, JwtTokenFilter::class.java) } }
修复完成后,公开路径的请求即使不带token,也会被正常放行,不会被JWT过滤器提前拦截;携带非法token的请求才会在JWT校验环节抛出对应的异常。
内容的提问来源于stack exchange,提问作者Annon
相关产品推荐
相关产品推荐

