Spring Boot如何配置双MySQL表实现分角色登录跳转

核心逻辑 #

直接替换Spring Security默认的单表查询UserDetailsService，自定义实现类依次查询users、admins两个表，匹配到账号后绑定对应的角色标识，登录成功后根据账号类型跳转对应dashboard。你之前写好的users表查询逻辑可以直接复用，只需要补充管理员表的查询和跳转逻辑即可。

具体实现步骤 #

1. 自定义登录用户实体 #

扩展Spring Security默认的User类，新增字段标记账号类型，方便后续做跳转判断：

// 注意导入正确的User父类
public class LoginUser extends org.springframework.security.core.userdetails.User {
    // 账号类型：user=普通用户，admin=管理员
    private String loginType;

    public LoginUser(String username, String password, 
                     Collection<? extends GrantedAuthority> authorities, 
                     String loginType) {
        super(username, password, authorities);
        this.loginType = loginType;
    }

    public String getLoginType() {
        return loginType;
    }

    public void setLoginType(String loginType) {
        this.loginType = loginType;
    }
}

2. 实现双表查询的UserDetailsService #

把你已有的普通用户查询逻辑和新增的管理员查询逻辑整合到同一个实现类里：

@Service
public class DualTableUserDetailsService implements UserDetailsService {
    // 你已有的普通用户表Mapper，直接注入即可
    @Autowired
    private UsersMapper usersMapper;
    // 新增管理员表Mapper，提前写好根据用户名查询的方法
    @Autowired
    private AdminsMapper adminsMapper;

    @Override
    public UserDetails loadUserByUsername(String username) throws UsernameNotFoundException {
        // 先查普通用户表
        Users normalUser = usersMapper.selectByUsername(username);
        if (normalUser != null) {
            // 绑定普通用户角色
            List<GrantedAuthority> auths = AuthorityUtils
                    .commaSeparatedStringToAuthorityList("ROLE_USER");
            return new LoginUser(normalUser.getUsername(), 
                    normalUser.getPassword(), auths, "user");
        }

        // 普通用户表无匹配再查管理员表
        Admins admin = adminsMapper.selectByUsername(username);
        if (admin != null) {
            // 绑定管理员角色
            List<GrantedAuthority> auths = AuthorityUtils
                    .commaSeparatedStringToAuthorityList("ROLE_ADMIN");
            return new LoginUser(admin.getUsername(), 
                    admin.getPassword(), auths, "admin");
        }

        // 两个表都查不到直接抛出账号不存在异常
        throw new UsernameNotFoundException("账号或密码错误");
    }
}

3. 修改Security配置类 #

替换默认的单表查询组件，配置不同角色的访问权限和登录成功跳转规则：

@Configuration
@EnableWebSecurity
public class SecurityConfig {
    @Autowired
    private DualTableUserDetailsService dualTableUserDetailsService;

    @Bean
    public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
        http
                .authorizeHttpRequests(auth -> auth
                        // 普通用户页面仅允许ROLE_USER访问
                        .requestMatchers("/user/dashboard/**").hasRole("USER")
                        // 管理员页面仅允许ROLE_ADMIN访问
                        .requestMatchers("/admin/dashboard/**").hasRole("ADMIN")
                        // 登录页、静态资源放行
                        .requestMatchers("/login", "/static/**").permitAll()
                        .anyRequest().authenticated()
                )
                .formLogin(form -> form
                        .loginPage("/login")
                        // 自定义登录成功逻辑，按账号类型跳转
                        .successHandler((request, response, authentication) -> {
                            LoginUser currentUser = (LoginUser) authentication.getPrincipal();
                            if ("admin".equals(currentUser.getLoginType())) {
                                response.sendRedirect("/admin/dashboard");
                            } else {
                                response.sendRedirect("/user/dashboard");
                            }
                        })
                        .permitAll()
                )
                // 替换为自定义的双表查询服务
                .userDetailsService(dualTableUserDetailsService);

        return http.build();
    }

    // 密码编码器保持你原来的配置即可，注意两个表的密码必须用相同规则加密
    @Bean
    public PasswordEncoder passwordEncoder() {
        return new BCryptPasswordEncoder();
    }
}

注意事项 #

• 如果业务场景下存在普通用户和管理员用户名重名的可能，建议在登录页增加身份选择单选框，登录时携带loginType参数，在loadUserByUsername里根据参数直接查询对应表，避免优先匹配普通用户导致管理员无法登录
• 角色标识不要写错，Spring Security默认会对hasRole()方法传入的角色名拼接ROLE_前缀，代码里绑定权限时要保持前缀一致
• 两个表的密码加密逻辑必须统一，否则会出现某一类账号密码校验不通过的问题

内容的提问来源于stack exchange，提问作者itsHoney