如何为Spring Security配置自定义登录界面（替换默认登录屏）

嘿，我来一步步帮你搞定Spring Security默认登录页的替换，用自己的自定义模板实现个性化定制。其实整个过程很清晰，分这几步来就行：

1. 创建自定义登录模板 #

首先你得先写好自己的登录页面，比如用Thymeleaf（Spring Boot常用的模板引擎）来做。这里给个基础示例，你可以根据自己的需求美化样式：

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>自定义登录页</title>
    <!-- 这里可以引入你的CSS文件 -->
    <link rel="stylesheet" th:href="@{/css/login.css}">
</head>
<body>
    <div class="login-container">
        <h2>欢迎登录</h2>
        <!-- 如果登录失败，显示错误信息 -->
        <div th:if="${param.error}" class="error-message">
            用户名或密码错误，请重新输入！
        </div>
        <!-- 登录表单，注意action和method，还有参数名 -->
        <form th:action="@{/login}" method="post">
            <div>
                <label>用户名：</label>
                <input type="text" name="username" required>
            </div>
            <div>
                <label>密码：</label>
                <input type="password" name="password" required>
            </div>
            <button type="submit">登录</button>
        </form>
    </div>
</body>
</html>

注意：默认情况下，Spring Security会期望用户名参数是username，密码是password，如果要改这些参数名，得在Security配置里额外指定，不过一般用默认的就好。

2. 配置Spring Security #

接下来要写Security的配置类，告诉Spring Security用我们的自定义登录页，而不是默认的。创建一个配置类，比如SecurityConfig：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
import org.springframework.security.web.SecurityFilterChain;

@Configuration
@EnableWebSecurity
public class SecurityConfig {

    @Bean
    public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
        http
            // 生产环境建议保留CSRF，Thymeleaf会自动为表单生成CSRF令牌，这里只是示例临时关闭
            .csrf(csrf -> csrf.disable())
            // 配置哪些请求不需要认证
            .authorizeHttpRequests(auth -> auth
                .requestMatchers("/login", "/css/**", "/js/**", "/images/**").permitAll() // 放行登录页和静态资源
                .anyRequest().authenticated() // 其他所有请求都需要认证
            )
            // 配置登录相关的设置
            .formLogin(form -> form
                .loginPage("/login") // 指定自定义登录页的访问路径
                .loginProcessingUrl("/login") // 表单提交的路径，要和模板里的action对应
                .defaultSuccessUrl("/home", true) // 登录成功后跳转的页面，true表示强制跳这里，不管之前的请求
                .failureUrl("/login?error=true") // 登录失败后跳转回登录页，带error参数
            )
            // 配置注销逻辑
            .logout(logout -> logout
                .logoutUrl("/logout")
                .logoutSuccessUrl("/login?logout=true")
                .permitAll()
            );

        return http.build();
    }
}

3. 处理登录错误提示 #

刚才的模板里已经加了th:if="${param.error}"来显示错误信息，这是因为Spring Security在登录失败时会自动重定向到/login?error，所以我们可以通过param.error来判断是否显示错误提示。

如果需要更详细的错误信息，你也可以自定义AuthenticationFailureHandler来处理，但大部分场景下用上面的简单方式就足够了。

4. 放行静态资源 #

别忘了，你的自定义登录页可能用到CSS、JS、图片这些静态资源，这些资源必须允许未认证的用户访问，所以在authorizeHttpRequests里加上requestMatchers("/css/**", "/js/**", "/images/**").permitAll()，这样用户在访问登录页时就能正常加载样式和脚本了。

最后验证 #

配置完这些之后，启动你的Spring Boot应用，访问任何需要认证的页面（比如/home），就会自动跳转到你的自定义登录页啦。输入正确的用户名密码就能登录成功，输错的话会显示错误提示，完全按照你的设计来展示。

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