Spring Security自定义表单登录报错：POST方法不支持问题求助

核心问题分析 #

日志报错HttpRequestMethodNotSupportedException: Request method 'POST' is not supported，结合代码来看，主要存在以下几处配置错误：

1. 表单提交地址与Security配置不匹配 #

前端登录表单的th:action="@{/login}"指向了仅支持GET请求的登录页面，但你的Security配置中指定了登录处理地址为/userAuth（loginProcessingUrl("/userAuth")），而/login路径只有控制器的@GetMapping处理，没有POST请求映射，导致提交POST请求时找不到对应处理方法。

修复方法：
修改前端表单的提交地址为配置的登录处理路径：

<form method="POST" role="form" th:action="@{/userAuth}">

2. 登录页面权限配置错误 #

SecurityConfig中requestMatchers("/login /register /search")的写法错误，空格分隔会被识别为单个路径/login /register /search，而非三个独立路径。这导致未登录用户无法访问/login页面（因为配置了hasAnyRole("USER", "ADMIN")），但登录页面本身应该允许匿名访问。

修复方法：
将路径改为逗号分隔，并允许匿名访问登录、注册页面：

.authorizeHttpRequests(requests -> requests
        .dispatcherTypeMatchers(DispatcherType.FORWARD, DispatcherType.INCLUDE).permitAll()
        .requestMatchers("/CSS/**").permitAll()
        .requestMatchers("/login", "/register").permitAll() // 允许匿名访问登录、注册页
        .requestMatchers("/search").hasAnyRole("USER", "ADMIN")
        .anyRequest().authenticated()
)

注：dispatcherTypeMatchers()需指定具体DispatcherType，避免潜在权限问题。

3. 用户名参数不匹配 #

Spring Security默认的用户名参数名是username，但你的前端表单中用户名输入框的name属性是nickName，若不配置参数映射，Security无法正确获取用户名进行认证。

修复方法：
在formLogin配置中添加usernameParameter("nickName")：

.formLogin(login -> login
        .loginPage("/login")
        .loginProcessingUrl("/userAuth")
        .usernameParameter("nickName") // 指定用户名参数名
        .defaultSuccessUrl("/register")
        .failureForwardUrl("/login?error")
        .permitAll())

完整修正后的SecurityConfig #

@Configuration
@EnableWebSecurity
public class SecurityConfig {

    @Bean
    public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
        http.csrf(csrf -> csrf.disable())
            .authorizeHttpRequests(requests -> requests
                .dispatcherTypeMatchers(DispatcherType.FORWARD, DispatcherType.INCLUDE).permitAll()
                .requestMatchers("/CSS/**").permitAll()
                .requestMatchers("/login", "/register").permitAll()
                .requestMatchers("/search").hasAnyRole("USER", "ADMIN")
                .anyRequest().authenticated()
            )
            .formLogin(login -> login
                .loginPage("/login")
                .loginProcessingUrl("/userAuth")
                .usernameParameter("nickName")
                .defaultSuccessUrl("/register")
                .failureForwardUrl("/login?error")
                .permitAll())
            .logout(logout -> logout
                .logoutRequestMatcher(new AntPathRequestMatcher("/logout"))
                .permitAll());

        return http.build();
    }
}

额外优化建议 #

• 登录成功后跳转到/register不符合逻辑，建议改为用户主页或其他已授权页面。
• 前端登录失败提示的alert alert-success应改为alert alert-danger，匹配错误提示的语义。

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