Spring Boot+Thymeleaf注册页错误无法显示自动跳转登录页问题

一、自动跳转到/login的原因 #

核心原因是Spring Security拦截了未认证的注册请求：

• 注册页面的GET路径（如/register）或提交注册的POST路径（如/register/save）未被配置为允许匿名访问，Security会默认将未认证的请求重定向到登录页/login。
• 少数情况是控制器方法在校验错误时误返回redirect:/login，但结合你描述的异常，更大概率是Security拦截规则配置问题。

二、TemplateInputException的根源 #

Thymeleaf渲染注册页时找不到userData对象或对应的BindingResult，具体原因：

1. 控制器POST方法参数顺序错误：@Valid修饰的User对象必须放在BindingResult之前，否则Spring无法将校验结果绑定到BindingResult，会直接抛出全局异常，导致返回页面时缺少必要的请求属性。
2. 显示注册页的GET方法未提前往Model中注入空的userData对象，Thymeleaf的th:object="${userData}"找不到目标对象。
3. 校验错误返回页面时，userData和BindingResult未被保留在Model中。

三、具体解决方案 #

1. 修正Spring Security配置 #

确保注册相关路径允许匿名访问：

@Configuration
@EnableWebSecurity
public class SecurityConfig {

    @Bean
    public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
        http
            .authorizeHttpRequests(auth -> auth
                // 放行注册页和注册提交接口
                .requestMatchers("/register", "/register/save").permitAll()
                // 其他请求需认证
                .anyRequest().authenticated()
            )
            .formLogin(form -> form
                // 自定义登录页路径（如果有）
                .loginPage("/login")
                .permitAll()
            );
        return http.build();
    }
}

2. 修正控制器代码 #

严格遵循参数顺序，同时提前注入空的userData到注册页：

@Controller
public class RegisterController {

    // 显示注册页面：提前放入空的userData对象
    @GetMapping("/register")
    public String showRegisterForm(Model model) {
        model.addAttribute("userData", new User());
        return "register";
    }

    // 处理注册提交：参数顺序必须是@Valid对象 → BindingResult → Model
    @PostMapping("/register/save")
    public String processRegister(@ModelAttribute("userData") @Valid User user,
                                  BindingResult bindingResult,
                                  Model model) {
        // 检查校验错误
        if (bindingResult.hasErrors()) {
            // @ModelAttribute已自动将userData注入Model，无需手动添加
            return "register"; // 返回注册页并携带错误信息
        }

        // 校验通过，执行注册逻辑（如保存用户到数据库）
        // userService.save(user);

        // 注册成功跳转到登录页
        return "redirect:/login";
    }
}

3. 实体类校验注解配置（示例） #

确保表单字段的校验规则正确：

public class User {
    @NotBlank(message = "用户名不能为空")
    private String username;

    @Email(message = "邮箱格式不正确")
    @NotBlank(message = "邮箱不能为空")
    private String email;

    @Size(min = 6, message = "密码至少需要6位")
    @NotBlank(message = "密码不能为空")
    private String password;

    // getter、setter方法
}

4. Thymeleaf页面展示错误信息 #

使用Thymeleaf表单校验标签渲染错误提示：

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>用户注册</title>
</head>
<body>
    <h2>用户注册</h2>
    <form th:action="@{/register/save}" th:object="${userData}" method="post">
        <!-- 用户名输入框及错误提示 -->
        <div>
            <label>用户名：</label>
            <input type="text" th:field="*{username}">
            <span th:if="${#fields.hasErrors('username')}" th:errors="*{username}" style="color: red;"></span>
        </div>

        <!-- 邮箱输入框及错误提示 -->
        <div>
            <label>邮箱：</label>
            <input type="email" th:field="*{email}">
            <span th:if="${#fields.hasErrors('email')}" th:errors="*{email}" style="color: red;"></span>
        </div>

        <!-- 密码输入框及错误提示 -->
        <div>
            <label>密码：</label>
            <input type="password" th:field="*{password}">
            <span th:if="${#fields.hasErrors('password')}" th:errors="*{password}" style="color: red;"></span>
        </div>

        <button type="submit">注册</button>
    </form>
</body>
</html>

四、验证步骤 #

1. 启动项目，访问/register，确认能正常打开注册页。
2. 提交不符合规则的表单数据（如空用户名、短密码），检查是否停留在注册页并显示对应错误。
3. 确认不会自动跳转到/login，说明Security配置生效。

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