Spring MVC中Kotlin结合Javax/Jakarta Validation与Thymeleaf验证失效求助

1. 清理依赖冲突 #

你引入的spring-boot-starter-validation已经包含了validation-api，无需单独添加javax.validation:validation-api:2.0.1.Final，重复引入会导致版本冲突。直接移除这个单独的依赖，保留starter即可：

implementation("org.springframework.boot:spring-boot-starter-validation")

注意：如果你的Spring Boot版本是3.x及以上，验证注解的包已从javax.validation.constraints迁移到jakarta.validation.constraints，需确保实体类中的注解导入正确：

// Spring Boot 3.x 需用 jakarta 包
import jakarta.validation.constraints.NotBlank
import jakarta.validation.constraints.NotEmpty
import jakarta.validation.constraints.Size

如果是Spring Boot 2.x，则使用javax.validation.constraints下的注解。

2. 优化实体类验证逻辑 #

你的Taco类中，ingredient字段同时使用@NotEmpty和@Size(min=1)，两者功能重复，保留@NotEmpty即可。另外确认默认值的影响：空字符串会触发@NotBlank验证，空列表会触发@NotEmpty验证，无需额外调整。

3. 修正Thymeleaf表单绑定 #

你的前端代码缺少<form>标签及th:object绑定，导致th:field无法关联到实体类属性，验证错误也无法回显。修改前端代码：

<form th:action="@{/processTaco}" th:object="${taco}" method="post">
    <div>
        <h3>Name your taco creation:</h3>
        <input type="text" th:field="*{name}"/>
        <span class="invalid-feedback"
              th:if="${#fields.hasErrors('name')}"
              th:errors="*{name}">name Error</span>
        <br/>
        <!-- 示例：配料复选框绑定到ingredient列表 -->
        <div th:each="ingredient : ${ingredients}">
            <input type="checkbox" th:field="*{ingredient}" th:value="${ingredient.id}"/>
            <label th:text="${ingredient.name}"></label>
        </div>
        <span class="invalid-feedback"
              th:if="${#fields.hasErrors('ingredient')}"
              th:errors="*{ingredient}">Ingredient Error</span>
        <br/>
        <button type="submit">Submit Your Taco</button>
    </div>
</form>

必须通过th:object="${taco}"将表单与控制器中的Taco对象绑定，才能让th:field正确映射属性并回显验证错误。

4. 排查参数绑定与验证错误 #

在控制器方法中添加日志，确认参数是否正确接收及验证错误详情：

@PostMapping("/processTaco")
fun processTaco(
    @Valid taco: Taco,
    bindingResult: BindingResult,
    @ModelAttribute tacoOrder: TacoOrder,
): String {
    println("Received Taco: $taco") // 检查参数接收情况
    if (bindingResult.hasErrors()) {
        bindingResult.allErrors.forEach { println("Validation Error: ${it.defaultMessage}") } // 打印错误信息
        return "design"
    }
    tacoOrder.addTaco(taco)
    println("Processing Taco:$taco")
    return "redirect:/orders/current"
}

如果参数接收异常，需检查表单字段名称与实体类属性名是否完全一致（Kotlin属性名是name和ingredient，表单字段需对应）。

5. 非Boot项目需手动配置验证器 #

如果是纯Spring MVC项目（非Spring Boot），需在配置类中启用验证功能：

@Configuration
@EnableWebMvc
class WebConfig : WebMvcConfigurer {
    override fun getValidator(): Validator {
        val factory = Validation.buildDefaultValidatorFactory()
        return factory.validator
    }
}

Spring Boot项目会自动配置，无需此步骤。

内容的提问来源于stack exchange，提问作者Saher Al-Sous