引入spring-boot-starter-validation后Thymeleaf注册页面无法加载

针对你遇到的问题，以下是几个核心排查方向和解决方法：

1. 依赖版本冲突问题 #

Spring Boot 2.3.x及以后版本，spring-boot-starter-validation需要手动引入，但如果依赖版本未通过Spring Boot父项目统一管理，容易和Thymeleaf相关依赖出现版本不兼容，引发模板解析异常。

解决方法：
确保pom.xml中使用Spring Boot父依赖管理所有starter版本，不要手动指定spring-boot-starter-validation或spring-boot-starter-thymeleaf的版本：

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>你的Spring Boot版本</version>
    <relativePath/>
</parent>

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-thymeleaf</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-validation</artifactId>
    </dependency>
    <!-- 其他业务依赖 -->
</dependencies>

2. Controller中@Valid与Errors的位置错误 #

Spring要求@Valid注解必须紧跟在要校验的参数前，且Errors参数必须直接放在该参数之后，否则无法绑定校验错误，进而引发模板渲染异常。

正确写法示例：

@PostMapping("/register")
public String processRegistration(
        @Valid @ModelAttribute("registrationForm") RegistrationForm form,
        Errors errors,
        Model model
) {
    if (errors.hasErrors()) {
        return "registration"; // 校验失败返回原页面展示错误
    }
    registrationServiceImpl.register(form);
    return "redirect:/login";
}

注意：@ModelAttribute指定的属性名必须和Thymeleaf模板中th:object绑定的名称完全一致。

3. Thymeleaf模板的错误表达式问题 #

模板中错误信息的获取方式如果有误，会在引入validation依赖后触发解析异常。

正确的模板写法示例：

<form th:action="@{/register}" th:object="${registrationForm}" method="post">
    <div>
        <label>姓名：</label>
        <input type="text" th:field="*{firstname}">
        <div th:if="${#fields.hasErrors('firstname')}" th:errors="*{firstname}" class="text-danger"></div>
    </div>
    <!-- 其他表单字段 -->
    <button type="submit">提交注册</button>
</form>

重点：

• th:object="${registrationForm}"必须和Controller中@ModelAttribute的名称匹配
• 错误信息用*{字段名}而非${字段名}，因为是基于th:object的对象属性

4. RegistrationForm的注解与访问权限问题 #

若校验字段无getter/setter，或者注解参数配置错误，会导致Spring校验失败并触发模板异常。

正确的RegistrationForm示例：

public class RegistrationForm {
    @Size(min = 2, max = 50, message = "姓名长度需在2-50字符之间")
    private String firstname;
    
    // 必须提供getter和setter，Spring校验和Thymeleaf回显都依赖它们
    public String getFirstname() {
        return firstname;
    }

    public void setFirstname(String firstname) {
        this.firstname = firstname;
    }

    // 其他字段及对应getter/setter
}

排查步骤总结 #

1. 先确认依赖版本通过Spring Boot父项目统一管理
2. 核对Controller中@Valid、Errors、@ModelAttribute的顺序和名称
3. 检查RegistrationForm的字段是否有完整的getter/setter，注解参数是否合法
4. 验证Thymeleaf模板中th:object和错误表达式的正确性

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