Spring Boot 3.x登录后跳转回登录页问题求助

问题背景 #

数据库中已存储正确的用户数据，但执行登录操作后始终跳转回登录页面，怀疑是Spring Security配置问题。

核心问题分析 #

你同时实现了自定义的/login POST接口和Spring Security表单登录功能，两者产生冲突：

• Spring Security的表单登录模块会优先拦截登录请求，导致你的自定义登录逻辑根本不会被执行
• 表单的action地址与Security配置的loginProcessingUrl不匹配，且自定义的明文密码校验不符合Security的认证规范

分步解决方案 #

1. 删除自定义登录接口 #

直接移除Controller中@PostMapping("/login")的方法，完全交由Spring Security处理登录认证流程。

2. 调整登录表单的action地址 #

将登录表单的action改为Security配置里的loginProcessingUrl值/login-process，同时保持字段名正确：

<body>
  <form action="/login-process" method="post">
    <label for="email">Email:</label>
    <input type="email" id="email" name="email" required><br>

    <label for="password">Password:</label>
    <input type="password" id="password" name="password" required><br>

    <input type="submit" value="Login">
  </form>
</body>

3. 修正Spring Security配置 #

调整配置，指定用户名参数为email，优化认证跳转逻辑，移除冲突设置：

@Bean
public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
    http
            .csrf().disable()
            .authorizeHttpRequests(auth -> auth
                    .requestMatchers("/", "/main", "/login", "/join").permitAll()
                    .requestMatchers(HttpMethod.POST, "/join").permitAll()
                    .anyRequest().authenticated() // 未列出的请求需认证
            )
            .formLogin(form -> form
                    .loginPage("/login")
                    .loginProcessingUrl("/login-process")
                    .usernameParameter("email") // 告诉Security用email作为用户名参数
                    .defaultSuccessUrl("/main", true) // 认证成功后强制跳转到main页面
                    .failureUrl("/login?error")
            );

    return http.build();
}

// 配置密码编码器，注册和认证时要使用同一个编码器
@Bean
public PasswordEncoder passwordEncoder() {
    return new BCryptPasswordEncoder();
}

4. 实现UserDetailsService对接数据库 #

让Spring Security能从数据库获取用户信息，必须实现UserDetailsService接口：

@Service
public class CustomUserDetailsService implements UserDetailsService {

    private final MemberRepository memberRepository;

    public CustomUserDetailsService(MemberRepository memberRepository) {
        this.memberRepository = memberRepository;
    }

    @Override
    public UserDetails loadUserByUsername(String email) throws UsernameNotFoundException {
        Member member = memberRepository.findByEmail(email)
                .orElseThrow(() -> new UsernameNotFoundException("用户不存在"));
        
        return User.builder()
                .username(member.getEmail())
                .password(member.getPassword()) // 注意：这里必须是加密后的密码
                .roles("USER") // 根据业务需求设置用户角色
                .build();
    }
}

5. 确保密码加密存储 #

注册用户时，必须使用PasswordEncoder加密密码后再存入数据库，示例：

@Service
public class MemberService {
    private final MemberRepository memberRepository;
    private final PasswordEncoder passwordEncoder;

    public MemberService(MemberRepository memberRepository, PasswordEncoder passwordEncoder) {
        this.memberRepository = memberRepository;
        this.passwordEncoder = passwordEncoder;
    }

    public void register(Member member) {
        // 加密密码后保存
        member.setPassword(passwordEncoder.encode(member.getPassword()));
        memberRepository.save(member);
    }
}

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