Java20+SpringBoot3.0.1同一属性多校验未按指定顺序触发问题求助

环境信息 #

• Java: 20
• Spring Boot: 3.0.1

原代码与问题 #

原字段校验代码：

@NotBlank(message = "userId id can not be blank.")
@NotEmpty(message = "userId id can not be empty.")
@UUID
@User
private String userId;

当请求不传入userId参数时，会随机返回上述4个注解的任意错误信息，期望校验在@NotBlank失败后立即终止，不再执行后续校验。

尝试使用GroupSequence指定顺序但未生效，代码如下：

@GroupSequence({Blank.class, Null.class, Empty.class, Custom.class, UserRequest.class})
@UserType
class UserRequest {
    @NotEmpty(groups = Empty.class, message = "userId id can not be empty.")
    @NotBlank(groups = Blank.class, message = "userId id can not be blank.")
    @NotNull(groups = Null.class, message = "userId id can not be null.")
    @UUID(groups = UID.class)
    @User(groups = Custom.class)
    private String userId;
}

问题原因 #

1. 分组遗漏：自定义注解@UUID使用的UID.class未加入GroupSequence中，导致该注解会被默认分组校验，不受序列控制。
2. 校验分组未指定：接口校验时未明确指定使用UserRequest的分组序列，依然用默认分组校验，导致顺序规则不生效。
3. 分组序列与注解对应关系混乱：部分分组未按期望的校验顺序排列，且自定义注解的分组未纳入整体序列。

修正方案 #

1. 补充分组并修正GroupSequence #

确保所有校验注解的分组都被包含进序列，同时按期望顺序排列：

// 定义分组标记接口
interface BlankCheck {}
interface NullCheck {}
interface EmptyCheck {}
interface UUIDCheck {}
interface UserCheck {}

@GroupSequence({BlankCheck.class, NullCheck.class, EmptyCheck.class, UUIDCheck.class, UserCheck.class, UserRequest.class})
class UserRequest {
    @NotBlank(groups = BlankCheck.class, message = "userId can not be blank.")
    @NotNull(groups = NullCheck.class, message = "userId can not be null.")
    @NotEmpty(groups = EmptyCheck.class, message = "userId can not be empty.")
    @UUID(groups = UUIDCheck.class)
    @User(groups = UserCheck.class)
    private String userId;
}

2. 接口校验时指定分组 #

在Controller接口方法中，用@Validated指定UserRequest.class作为校验分组（因为GroupSequence定义在UserRequest上，指定该类即可触发序列校验）：

@PostMapping("/user")
public ResponseEntity<String> createUser(@Validated(UserRequest.class) @RequestBody UserRequest request) {
    // 业务逻辑处理
    return ResponseEntity.ok("success");
}

3. 额外说明 #

• Hibernate Validator的GroupSequence会严格按序列顺序执行校验，一旦某一组校验失败，后续分组的校验会直接终止。
• 注意@NotBlank、@NotNull、@NotEmpty的逻辑重叠：当参数为null时，@NotNull和@NotBlank都会失败，但由于序列中BlankCheck在前，会优先返回@NotBlank的错误信息。

内容的提问来源于stack exchange，提问作者Prafulla Kumar Sahu