Spring Boot登录页面无法登录 无报错问题求助

核心问题汇总 #

你的登录流程无法正常工作，核心原因是User实体类的UserDetails实现完全错误，再加上路由、Security配置、前端表单等多处细节问题，导致认证逻辑根本无法执行。

1. User实体类（致命错误） #

实现UserDetails接口的方法全部写错，直接导致用户被判定为无效账号：

@Data
@Entity
@Table(name = "Users")
public class User implements UserDetails {
    // ... 原有字段省略 ...

    // 修复后的UserDetails实现方法
    @Override
    public Collection<? extends GrantedAuthority> getAuthorities() {
        // 不能返回null，返回空集合即可
        return Collections.emptyList();
    }

    @Override
    public String getUsername() {
        // 返回实体类中真实的username字段，不是固定字符串
        return this.username;
    }

    @Override
    public String getPassword() {
        // 实体类中密码字段是pass，返回这个字段
        return this.pass;
    }

    @Override
    public boolean isAccountNonExpired() {
        // 账号未过期，返回true
        return true;
    }

    @Override
    public boolean isAccountNonLocked() {
        // 账号未锁定，返回true
        return true;
    }

    @Override
    public boolean isCredentialsNonExpired() {
        // 凭证未过期，返回true
        return true;
    }

    @Override
    public boolean isEnabled() {
        // 账号启用状态，返回true
        return true;
    }
}

错误说明：
原方法返回固定字符串/null/false，Spring Security会直接判定用户账号过期、锁定、凭证失效或禁用，拒绝所有登录请求。

2. 控制器路由问题 #

原路由冲突且逻辑错误，修复后：

@Controller
public class MusicrewPageController {

    // 根路径直接返回登录页
    @GetMapping("/")
    public String root() {
        return "login";
    }

    // 处理登录成功后的/top页面，原login路径的GetMapping会覆盖登录页路由
    @GetMapping("/top")
    public String showList(Authentication loginUser, Model model) {
        // Spring Security不会暴露原始密码，用getName()获取用户名
        model.addAttribute("username", loginUser.getName());
        model.addAttribute("authority", loginUser.getAuthorities());
        return "user";
    }
}

错误说明：

• 原@GetMapping("login")会拦截登录页请求，未登录时Authentication对象为null，会抛出空指针异常
• 模型属性名" username"多了空格，前端无法正确获取数据

3. Security配置与UserDetailsServiceImpl问题 #

3.1 SecurityConfig修复

@Configuration
public class SecurityConfig {

    @Bean
    public PasswordEncoder passwordEncoder() {
        return new BCryptPasswordEncoder();
    }

    @Bean
    public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
        http
                .authorizeHttpRequests(auth -> auth
                        // 修正拼写错误：memberRegirstration → memberRegistration
                        .requestMatchers("/", "/login", "/memberRegistration", "/css/**", "/images/**")
                        .permitAll()
                        .anyRequest().authenticated())
                .formLogin(login -> login
                        .loginPage("/login") // 指定自定义登录页
                        .loginProcessingUrl("/login") // 登录请求提交路径（默认就是/login，明确写更清晰）
                        .defaultSuccessUrl("/top") // 登录成功后跳转路径
                        .permitAll())
                .rememberMe();
        return http.build();
    }
}

3.2 UserDetailsServiceImpl修复

// 必须加@Service注解，让Spring识别并加载这个Bean
@Service
public class UserDetailsServiceImpl implements UserDetailsService {

    // 修正拼写错误：userReposiroty → userRepository
    @Autowired
    private UserRepository userRepository;

    @Override
    public UserDetails loadUserByUsername(String username) throws UsernameNotFoundException {
        User user = userRepository.findByUsername(username);
        if (user == null) {
            throw new UsernameNotFoundException("User Not Found");
        }
        // 直接返回user，因为User已经实现了UserDetails接口
        return user;
    }
}

错误说明：

• 原UserDetailsServiceImpl没有@Service注解，Spring无法自动装配，导致认证逻辑不生效
• 路径拼写错误memberRegirstration，导致注册页无法被放行

4. 前端表单问题 #

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>Musicrew Login</title>
    <link rel="stylesheet" th:href="@{/css/login.css}">
</head>
<body>
    <div class="login-page">
        <img th:src="@{images/loginpage.jpg}">
        <div id="login-page-rightside">
            <img th:src="@{images/MusicrewLogo.png}">
            <div>
                <!-- 修正表单提交路径：从/top改为/login -->
                <form id="form" th:action="@{/login}" method="post" >
                    <label class="label-username">username</label>
                    <input class="text-box" type="text" name="username">

                    <label class="label-password">password</label>
                    <input class="text-box" type="password" name="password"><br>

                    <!-- 增加name属性，对应Spring Security的remember-me参数 -->
                    <input class="remember-me" type="checkbox" name="remember-me">
                    <label class="remember-me">remember me</label>
                    
                    <label class="forget-password">パスワードを忘れた方はこちら</label><br>

                    <input type="submit" value="login" id="login-button">
                    <br>
                </form>

                <form th:action="@{/memberRegistration}" id="form">
                    <input type="submit" value="sign up" id="signup-button">
                </form>
            </div>
        </div>
    </div>
</body>
</html>

错误说明：

• 原表单提交到/top，而Spring Security的登录处理路径是/login（POST），导致认证逻辑无法触发
• "remember me"复选框没有name属性，无法开启记住我功能

5. 数据库配置优化 #

# 连接业务数据库，不要用mysql系统库
spring.datasource.url=jdbc:mysql://localhost:3306/musicrew?useSSL=false&serverTimezone=UTC
spring.datasource.username=root
spring.datasource.password=Urak4812Urak4812
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
# MySQL8+用MySQL8Dialect，避免版本兼容问题
spring.jpa.database-platform=org.hibernate.dialect.MySQL8Dialect
# 可选：开启SQL日志，方便排查数据查询问题
spring.jpa.show-sql=true

修复后验证步骤 #

1. 确保数据库中用户的pass字段是BCrypt加密后的密码（可以通过passwordEncoder.encode("原始密码")生成）
2. 启动应用，访问/login页面
3. 输入正确的用户名和对应原始密码，点击登录，应该能跳转到/top页面

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