Spring Boot自定义注解校验嵌套字段未触发问题求助

我来帮你排查这个问题，嵌套字段校验器没触发通常是因为嵌套对象的校验逻辑没有被正确触发，或者配置细节没到位。咱们一步步来梳理：

1. 确认@Valid注解的位置是否正确 #

你提到已经尝试加了@Valid，但大概率是加错了位置——必须在父类中嵌套对象的字段上添加@Valid，而不是嵌套类内部的字段上。

修改MyRequest类：

data class MyRequest(
    @JsonProperty("nested")
    @Valid // 重点！加在这个嵌套字段上，触发嵌套对象的递归校验
    val nested: NestedClass? = null,
    @JsonProperty("locale")
    val locale: String? = null
)

NestedClass保持原有注解即可：

data class NestedClass(
    @JsonProperty("example")
    @CustomValidation
    val example: String? = null
)

@Valid的核心作用就是告诉Spring：这个嵌套对象内部的校验注解也需要被执行，相当于开启嵌套校验的开关。

2. 检查自定义校验器的泛型匹配 #

你的CustomValidator泛型是ConstraintValidator<CustomValidation, String>，而NestedClass的example字段是String?，这部分类型匹配是没问题的。如果后续嵌套字段类型调整，要确保泛型的第二个参数和字段类型严格对应（Kotlin的可空类型?会被Spring Validation正常处理）。

3. 排查Spring Validation的自动配置 #

• 确保Spring Boot的Validation自动配置没被禁用：检查application.properties/application.yml里有没有spring.autoconfigure.exclude包含ValidationAutoConfiguration，如果有，移除这个配置项。
• 注意Spring Boot版本对应的Valid包：Spring Boot 3.x使用jakarta.validation.Valid，Spring Boot 2.x使用javax.validation.Valid，不要混用两个包下的注解。

4. 移除校验器上的@Component注解（可选） #

虽然@Component不会直接导致错误，但Spring Validation机制会自动实例化ConstraintValidator，手动添加@Component可能会导致多个实例存在，偶尔引发奇怪的执行问题。可以尝试去掉这个注解：

// @Component 移除该注解
class CustomValidator : ConstraintValidator<CustomValidation, String> {
    override fun isValid(field: String?, context: ConstraintValidatorContext?): Boolean {
        return field == "example"
    }
}

5. 检查全局异常处理器是否拦截了校验结果 #

如果你的项目有自定义全局异常处理器（@RestControllerAdvice修饰），要确保没有漏掉处理MethodArgumentNotValidException——这是Spring校验不通过时抛出的核心异常。如果处理器没处理这个异常，可能会让你误以为校验没触发。

示例异常处理器片段：

@RestControllerAdvice
class GlobalExceptionHandler {
    @ExceptionHandler(MethodArgumentNotValidException::class)
    fun handleValidationExceptions(ex: MethodArgumentNotValidException): ResponseEntity<Map<String, String>> {
        val errors = ex.bindingResult.fieldErrors.associate { 
            it.field to it.defaultMessage.toString() 
        }
        return ResponseEntity.badRequest().body(errors)
    }
}

6. 测试时确保请求体正确传递 #

最后，测试时要确保请求体里确实包含了嵌套对象的字段，比如：

{
  "nested": {
    "example": "wrong-value"
  },
  "locale": "en"
}

如果请求中nested字段为null，校验器自然不会被触发哦。

内容的提问来源于stack exchange，提问作者Kacper Opyrchał