如何配置Spring MVC验证Kotlin控制器方法参数的构造器参数

这个问题我之前也碰到过！本质是Kotlin和Spring Bean Validation的注解处理逻辑差异导致的：默认情况下，Kotlin会把@Email、@NotBlank这类约束注解绑定到数据类的构造器参数上，而Spring的@Valid注解默认只会识别字段（field）上的约束规则，所以才会出现验证不生效的情况。

最直接的解决方案：指定注解的使用站点目标 #

给每个约束注解加上@field:前缀，明确告诉Kotlin把注解编译到字段上，这样Spring就能正确识别并触发验证了。修改后的代码如下：

data class Credentials(
    @field:Email 
    @field:NotBlank 
    val email: String,
    
    @field:NotBlank 
    val password: String
)

@PostMapping("/token") 
fun generateToken(@RequestBody @Valid credentials: Credentials) { 
    /* 业务逻辑 */ 
}

可选：全局配置（Spring Boot 2.2+） #

如果你的项目里有很多数据类需要做类似的验证，也可以通过配置Kotlin编译器参数，让它默认把构造器参数上的注解同步到字段上。以Gradle Kotlin DSL为例，在build.gradle.kts里添加：

tasks.withType<KotlinCompile> {
    kotlinOptions {
        freeCompilerArgs = listOf("-Xjsr305=strict", "-Xemit-jvm-type-annotations")
    }
}

不过这种全局方式灵活性稍差，如果某些场景需要注解保留在构造器参数上就不太方便，所以更推荐显式添加@field:的方式，代码可读性也更强。

最后别忘了检查项目是否引入了Spring Validation的依赖，比如Spring Boot项目要确保包含spring-boot-starter-validation，不然验证逻辑本身也无法正常运行。

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