三个步骤完成过滤器自定义添加

第一步在自己模块下创建想要的过滤器

编写自己的过滤器

package com.ruoyi.agriculture.filter;

import com.fasterxml.jackson.databind.ObjectMapper;
import com.ruoyi.agriculture.domain.WxGKUser;
import com.ruoyi.agriculture.mapper.WxGKUserMapper;
import jakarta.servlet.FilterChain;
import jakarta.servlet.ServletException;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.core.Ordered;
import org.springframework.core.annotation.Order;
import org.springframework.data.redis.core.StringRedisTemplate;
import org.springframework.security.authentication.UsernamePasswordAuthenticationToken;
import org.springframework.security.core.context.SecurityContextHolder;
import org.springframework.security.web.authentication.WebAuthenticationDetailsSource;
import org.springframework.stereotype.Component;
import org.springframework.util.StringUtils;
import org.springframework.web.filter.OncePerRequestFilter;

import java.io.IOException;
import java.util.concurrent.TimeUnit;

/**
 * 微信小程序认证过滤器
 * 专门处理微信小程序的token验证
 */
@Order(85)  // 使用@Order注解指定顺序，值越小越先执行
@Component
public class GKWxAuthFilter extends OncePerRequestFilter implements Ordered {
    @Override
    public int getOrder() {
        System.out.println("GKWxAuthFilter 执行，URI：" );
        return 85;
    }

    // Redis中微信token的前缀，用于与系统其他token区分
    private static final String GK_TOKEN_PREFIX = "wx_Token:";

    // 微信小程序接口的基础路径，用于过滤需要处理的请求
    private static final String GK_API_PREFIX = "/wx/";

    // Jackson的JSON处理工具（Spring默认已集成）
    private static final ObjectMapper objectMapper = new ObjectMapper();

    @Autowired
    private StringRedisTemplate stringRedisTemplate;

    @Autowired
    private WxGKUserMapper wxGKUserMapper;

    // 移除原writeErrorResponse方法，替换为抛出异常
    @Override
    protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response,
                                    FilterChain filterChain) throws ServletException, IOException {

        System.out.println("GKWxAuthFilter 执行，URI：" + request.getRequestURI());
        if (request.getRequestURI().startsWith(GK_API_PREFIX)) {
            String gkToken = request.getHeader("wx-token");

            if (isPublicWxApi(request.getRequestURI())) {
                filterChain.doFilter(request, response);
                return;
            }

            // 验证token是否存在
            if (!StringUtils.hasText(gkToken)) {
                throw new GKWxAuthenticationException("微信登录凭证不存在，请重新登录");
            }

            // 从Redis获取用户ID
            String userIdStr = stringRedisTemplate.opsForValue().get(GK_TOKEN_PREFIX + gkToken);
            if (!StringUtils.hasText(userIdStr)) {
                throw new GKWxAuthenticationException("微信登录凭证已过期，请重新登录");
            }

            // 刷新token有效期
            stringRedisTemplate.expire(GK_TOKEN_PREFIX + gkToken, 7, TimeUnit.DAYS);

            // 查询用户信息
            Long userId;
            try {
                userId = Long.parseLong(userIdStr);
            } catch (NumberFormatException e) {
                throw new GKWxAuthenticationException("用户ID格式错误");
            }

            WxGKUser user = wxGKUserMapper.selectById(userId);
            if (user == null) {
                throw new GKWxAuthenticationException("用户不存在");
            }

            // 设置认证信息
            UsernamePasswordAuthenticationToken authentication =
                    new UsernamePasswordAuthenticationToken(user, null, null);
            authentication.setDetails(new WebAuthenticationDetailsSource().buildDetails(request));
            SecurityContextHolder.getContext().setAuthentication(authentication);
        }

        filterChain.doFilter(request, response);
    }

    /**
     * 判断是否为微信公开接口
     */
    private boolean isPublicWxApi(String requestUri) {
        return requestUri.startsWith("/wx/user/login") ||
                requestUri.startsWith("/wx/user/register") ||
                requestUri.startsWith("/wx/user/privacy");
    }
}

定义的异常类

package com.ruoyi.agriculture.filter;

import org.springframework.security.core.AuthenticationException;

public class GKWxAuthenticationException extends AuthenticationException {




    public GKWxAuthenticationException(String msg) {
        super(msg);
    }

//    public GkWxAuthenticationException(String msg, Throwable cause) {
//        super(msg, cause);
//    }
}

第二步在framework模块下操作，记得要把自己的模块引入

com/ruoyi/framework/security/filter/JwtAuthenticationTokenFilter.java 找到若依自己的过滤器在里面进行一些修改 对微信接口直接放行，不进行JWT验证

package com.ruoyi.framework.security.filter;

import java.io.IOException;
import jakarta.servlet.FilterChain;
import jakarta.servlet.ServletException;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import org.springframework.beans.factory.annotation.Autowired;

import org.springframework.core.Ordered;
import org.springframework.core.annotation.Order;
import org.springframework.security.authentication.UsernamePasswordAuthenticationToken;
import org.springframework.security.core.context.SecurityContextHolder;
import org.springframework.security.web.authentication.WebAuthenticationDetailsSource;
import org.springframework.stereotype.Component;
import org.springframework.web.filter.OncePerRequestFilter;
import com.ruoyi.common.core.domain.model.LoginUser;
import com.ruoyi.common.utils.SecurityUtils;
import com.ruoyi.common.utils.StringUtils;
import com.ruoyi.framework.web.service.TokenService;

/**
 * token过滤器 验证token有效性
 * 
 * @author ruoyi
 */
@Order(90)  // JWT过滤器顺序应在微信过滤器之后
@Component
public class JwtAuthenticationTokenFilter extends OncePerRequestFilter implements Ordered
{
    @Autowired
    private TokenService tokenService;
    @Override
    public int getOrder() {
        return 90;
    }


    @Override
    protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain chain)
            throws ServletException, IOException
    {

        System.out.println("JwtAuthenticationTokenFilter 构造方法被调用");

        // 对微信接口直接放行，不进行JWT验证
        if (request.getRequestURI().startsWith("/wx/")) {
            chain.doFilter(request, response);
            return;
        }

        LoginUser loginUser = tokenService.getLoginUser(request);
        if (StringUtils.isNotNull(loginUser) && StringUtils.isNull(SecurityUtils.getAuthentication()))
        {
            tokenService.verifyToken(loginUser);
            UsernamePasswordAuthenticationToken authenticationToken = new UsernamePasswordAuthenticationToken(loginUser, null, loginUser.getAuthorities());
            authenticationToken.setDetails(new WebAuthenticationDetailsSource().buildDetails(request));
            SecurityContextHolder.getContext().setAuthentication(authenticationToken);
        }
        chain.doFilter(request, response);
    }
}

第三步将这些接口放行后，还需要对spring security配置进行修改将自己的过滤器注入到里面去

package com.ruoyi.framework.config;


import com.ruoyi.agriculture.filter.GKWxAuthFilter;
import com.ruoyi.framework.security.filter.WxAuthFilter;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.CommandLineRunner;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.annotation.Order;
import org.springframework.http.HttpMethod;
import org.springframework.security.authentication.AuthenticationManager;
import org.springframework.security.authentication.ProviderManager;
import org.springframework.security.authentication.dao.DaoAuthenticationProvider;
import org.springframework.security.config.annotation.method.configuration.EnableMethodSecurity;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.http.SessionCreationPolicy;
import org.springframework.security.core.userdetails.UserDetailsService;
import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;
import org.springframework.security.web.SecurityFilterChain;
import org.springframework.security.web.authentication.UsernamePasswordAuthenticationFilter;
import org.springframework.security.web.authentication.logout.LogoutFilter;
import com.ruoyi.framework.config.properties.PermitAllUrlProperties;
import com.ruoyi.framework.security.filter.JwtAuthenticationTokenFilter;
import com.ruoyi.framework.security.handle.AuthenticationEntryPointImpl;
import com.ruoyi.framework.security.handle.LogoutSuccessHandlerImpl;
import org.springframework.core.Ordered;
import org.springframework.stereotype.Component;
import org.springframework.web.cors.CorsConfiguration;
import org.springframework.web.cors.CorsConfigurationSource;
import org.springframework.web.cors.UrlBasedCorsConfigurationSource;

import static org.springframework.security.config.Customizer.withDefaults;

/**
 * spring security配置
 * 
 * @author ruoyi
 */
@EnableMethodSecurity(prePostEnabled = true, securedEnabled = true)
@Configuration
public class SecurityConfig
{
    /**
     * 自定义用户认证逻辑
     */
    @Autowired
    private UserDetailsService userDetailsService;
    
    /**
     * 认证失败处理类
     */
    @Autowired
    private AuthenticationEntryPointImpl unauthorizedHandler;

    /**
     * 退出处理类
     */
    @Autowired
    private LogoutSuccessHandlerImpl logoutSuccessHandler;

    /**
     * token认证过滤器
     */
    @Autowired
    private JwtAuthenticationTokenFilter authenticationTokenFilter;

    
    @Autowired
    private WxAuthFilter wxAuthFilter;

    /**
     * 微信小程序专用认证过滤器
     */
    @Autowired
    private GKWxAuthFilter gkWxAuthFilter;   // 注入

    /**
     * 允许匿名访问的地址
     */
    @Autowired
    private PermitAllUrlProperties permitAllUrl;



    /**
     * 身份验证实现
     */
    @Bean
    public AuthenticationManager authenticationManager()
    {
        DaoAuthenticationProvider daoAuthenticationProvider = new DaoAuthenticationProvider();
        daoAuthenticationProvider.setUserDetailsService(userDetailsService);
        daoAuthenticationProvider.setPasswordEncoder(bCryptPasswordEncoder());
        return new ProviderManager(daoAuthenticationProvider);
    }

    /**
     * anyRequest          |   匹配所有请求路径
     * access              |   SpringEl表达式结果为true时可以访问
     * anonymous           |   匿名可以访问
     * denyAll             |   用户不能访问
     * fullyAuthenticated  |   用户完全认证可以访问（非remember-me下自动登录）
     * hasAnyAuthority     |   如果有参数，参数表示权限，则其中任何一个权限可以访问
     * hasAnyRole          |   如果有参数，参数表示角色，则其中任何一个角色可以访问
     * hasAuthority        |   如果有参数，参数表示权限，则其权限可以访问
     * hasIpAddress        |   如果有参数，参数表示IP地址，如果用户IP和参数匹配，则可以访问
     * hasRole             |   如果有参数，参数表示角色，则其角色可以访问
     * permitAll           |   用户可以任意访问
     * rememberMe          |   允许通过remember-me登录的用户访问
     * authenticated       |   用户登录后可访问
     */
    @Bean
    protected SecurityFilterChain filterChain(HttpSecurity httpSecurity) throws Exception
    {
            return httpSecurity
             // 采用Spring Security6.x拥抱springboot3默认的CORS配置
            .cors(withDefaults())
            // CSRF禁用，因为不使用session
            .csrf(csrf -> csrf.disable())
            // 禁用HTTP响应标头
            .headers((headersCustomizer) -> {
                headersCustomizer.cacheControl(cache -> cache.disable()).frameOptions(options -> options.sameOrigin());
            })
            // 认证失败处理类
            .exceptionHandling(exception -> exception.authenticationEntryPoint(unauthorizedHandler))
            // 基于token，所以不需要session
            .sessionManagement(session -> session.sessionCreationPolicy(SessionCreationPolicy.STATELESS))
            // 注解标记允许匿名访问的url
            .authorizeHttpRequests((requests) -> {
                permitAllUrl.getUrls().forEach(url -> requests.requestMatchers(url).permitAll());
                // 微信小程序接口配置
                requests.requestMatchers("/wx/user/login").permitAll() // 小程序登录允许匿名访问
                        .requestMatchers("/wx/user/register").permitAll() // 小程序注册允许匿名访问
                        .requestMatchers("/wx/user/privacy").permitAll() // 隐私政策允许匿名访问
                        // 微信其他接口需要认证
                        .requestMatchers("/wx/**").authenticated();

                // 对于登录login 注册register 验证码captchaImage 允许匿名访问
                requests.requestMatchers("/login", "/register", "/captchaImage").permitAll()
                    // 静态资源，可匿名访问
                    .requestMatchers(HttpMethod.GET, "/", "/*.html", "/**.html", "/**.css", "/**.js", "/profile/**").permitAll()
                    .requestMatchers("/swagger-ui.html", "/v3/api-docs/**", "/swagger-ui/**", "/druid/**").permitAll()

                    // 除上面外的所有请求全部需要鉴权认证
                    .anyRequest().authenticated();
            })
            .logout(logout -> logout.logoutUrl("/logout").logoutSuccessHandler(logoutSuccessHandler))
            .addFilterBefore(authenticationTokenFilter, UsernamePasswordAuthenticationFilter.class)
                    .addFilterBefore(gkWxAuthFilter, JwtAuthenticationTokenFilter.class)  .build();


    }

    /**
     * 强散列哈希加密实现
     */
    @Bean
    public BCryptPasswordEncoder bCryptPasswordEncoder()
    {
        return new BCryptPasswordEncoder();
    }

    /**
     *  跨域配置
     *  允许跨域访问
     *  允许所有请求
     *  允许所有请求头
     *  允许所有方法
     *  允许所有请求源
     *  允许所有请求路径
     * */
    @Bean
    public CorsConfigurationSource corsConfigurationSource() {
        CorsConfiguration configuration = new CorsConfiguration();
        configuration.addAllowedOriginPattern("*");
        configuration.addAllowedMethod("*");
        configuration.addAllowedHeader("*");
        configuration.setAllowCredentials(true);
        UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
        source.registerCorsConfiguration("/**", configuration);
        return source;
    }
}

GKWxAuthFilter 就会正确加入到 Security 过滤器链中， /wx/ 请求会被它处理。

# java
Logo
https://edu.csdn.net/learn/39067/627173?utm_source=2019755004

汇聚全球AI编程工具，助力开发者即刻编程。

更多推荐

cover

【上海】用户做GEO怕踩坑？适配本地的方案来了

avatar AI编程社区
cover

7行字的“神级Skill“，全网安装610万次

avatar AI编程社区
cover

Claude Code 从 0 到 1：安装、配置与使用，一篇讲清楚

avatar AI编程社区