Spring Kotlin项目中Javax Validation @ConvertGroup注解失效问题

1. 修正注解目标与位置 #

Kotlin的注解默认作用目标和Java存在差异，必须明确指定@Valid和@ConvertGroup的作用目标为属性（PROPERTY）或字段（FIELD），确保验证框架正确识别分组转换规则。

示例代码：

import javax.validation.Valid
import javax.validation.groups.ConvertGroup
import javax.validation.constraints.NotNull

data class Restaurant(
    // 其他字段
    @get:Valid
    @get:ConvertGroup(from = Default::class, to = Groups.CuisineId::class)
    val cuisine: Cuisine? = null
)

data class Cuisine(
    @field:NotNull(groups = [Groups.CuisineId::class])
    val id: Long?,
    @field:NotNull(groups = [Default::class])
    val name: String?
)

• 使用@get:让注解作用于属性getter方法，和Java默认行为对齐；
• 确保Cuisine的id仅在Groups.CuisineId分组下触发非空校验，name仅在默认分组下校验。

2. 处理Kotlin空安全与反序列化问题 #

若Cuisine字段声明为非空类型（val cuisine: Cuisine），反序列化时框架会自动实例化空对象，导致name字段为null触发校验。需将关联字段设为可空：

val cuisine: Cuisine? = null

同时可配置Jackson避免实例化空对象（Spring Boot环境）：

spring:
  jackson:
    deserialization:
      fail-on-empty-beans: false
      accept-empty-string-as-null-object: true

3. 确保依赖与注解处理器配置 #

• 引入kotlin-reflect依赖，Hibernate Validator需要它处理Kotlin属性反射：

// Gradle
implementation("org.jetbrains.kotlin:kotlin-reflect")

// Maven
<dependency>
    <groupId>org.jetbrains.kotlin</groupId>
    <artifactId>kotlin-reflect</artifactId>
</dependency>

• 添加Hibernate Validator注解处理器，确保Kotlin注解被正确编译处理：

// Gradle
kapt("org.hibernate.validator:hibernate-validator-annotation-processor:7.0.4.Final")

// Maven
<dependency>
    <groupId>org.hibernate.validator</groupId>
    <artifactId>hibernate-validator-annotation-processor</artifactId>
    <version>7.0.4.Final</version>
    <scope>provided</scope>
</dependency>

4. 控制器层明确指定验证分组 #

在控制器方法上用@Validated指定主分组，确保@ConvertGroup的from参数与之一致：

import org.springframework.validation.annotation.Validated
import org.springframework.web.bind.annotation.PostMapping
import org.springframework.web.bind.annotation.RequestBody

@PostMapping("/restaurants")
fun createRestaurant(
    @Validated(Groups.RestaurantCreation::class)
    @RequestBody restaurant: Restaurant
) {
    // 业务逻辑实现
}

对应调整Restaurant的注解：

@get:ConvertGroup(from = Groups.RestaurantCreation::class, to = Groups.CuisineId::class)
@get:Valid
val cuisine: Cuisine? = null

5. 排查版本兼容性 #

避免使用过旧的Hibernate Validator版本，推荐使用7.x及以上版本，这类版本对Kotlin的支持更完善。

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