Spring Boot类级别ConstraintValidator校验缺失错误消息如何解决

根因分析 #

@PasswordConfirmation属于类级别的校验注解，校验不通过时默认生成的是全局ObjectError，而非字段级FieldError。若你的全局异常处理器仅遍历了FieldError，就会遗漏类级别的错误信息，导致响应中没有对应提示。

方案一（推荐）：绑定错误到指定字段 #

该方案无需修改现有异常处理逻辑，仅调整校验器代码，将类级别错误绑定到passwordConfirmation字段，和字段级校验的返回格式完全兼容：

@Component
public class PasswordConfirmationValidator implements ConstraintValidator<PasswordConfirmation, SecurityCredentialsRequest> {
    @Override
    public void initialize (final PasswordConfirmation constraintAnnotation) {
    }

    @Override
    public boolean isValid(SecurityCredentialsRequest securityCredentialsRequest, ConstraintValidatorContext constraintValidatorContext) {
        String password = securityCredentialsRequest.getPassword();
        String passwordConfirmation = securityCredentialsRequest.getPasswordConfirmation();
        boolean isValid = password != null && password.equals(passwordConfirmation);

        if (!isValid) {
            // 禁用默认全局错误生成
            constraintValidatorContext.disableDefaultConstraintViolation();
            // 手动绑定错误到密码确认字段
            constraintValidatorContext.buildConstraintViolationWithTemplate(
                    constraintValidatorContext.getDefaultConstraintMessageTemplate()
                )
                .addPropertyNode("passwordConfirmation")
                .addConstraintViolation();
        }
        return isValid;
    }
}

调整后错误会作为passwordConfirmation字段的校验异常返回，前端可直接关联到对应输入框提示，符合常规使用逻辑。

方案二：扩展全局异常处理逻辑 #

如果不需要绑定错误到具体字段，可修改全局异常处理器，新增全局ObjectError的遍历逻辑：

@RestControllerAdvice
public class GlobalValidationExceptionHandler {

    @ExceptionHandler(MethodArgumentNotValidException.class)
    public ResponseEntity<Map<String, Object>> handleValidError(MethodArgumentNotValidException e) {
        Map<String, Object> resp = new LinkedHashMap<>();
        resp.put("timestamp", LocalDateTime.now());
        List<Map<String, Object>> errorList = new ArrayList<>();

        // 原有字段错误处理
        for (FieldError fieldError : e.getBindingResult().getFieldErrors()) {
            Map<String, Object> err = new HashMap<>();
            err.put("field", fieldError.getField());
            err.put("message", fieldError.getDefaultMessage());
            // 自定义错误码逻辑自行补充
            errorList.add(err);
        }

        // 新增类级别全局错误处理
        for (ObjectError globalError : e.getBindingResult().getGlobalErrors()) {
            Map<String, Object> err = new HashMap<>();
            // 类级别错误无绑定字段，可自定义field值如global
            err.put("field", "global");
            err.put("message", globalError.getDefaultMessage());
            errorList.add(err);
        }

        resp.put("errors", errorList);
        return ResponseEntity.badRequest().body(resp);
    }
}

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