You need to enable JavaScript to run this app. Spring Boot自定义JWT过滤器permitAll失效 无token请求被拦截
优惠活动
大模型
产品
解决方案
定价
更多

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容器管理的单例,虽然不是本次问题的核心原因,但会带来依赖失效、行为不一致的潜在问题。

分步修复方案

  1. 修正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)
        }
    }
    
  2. 调整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)
    }
    
  3. 优化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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.11 22:06:03