Validation Errors

Returning validation errors for HTTP request arguments.

Library overrides default responses for jakarta.validation exceptions for both @RequestBody and any other @RestController arguments.

{
  "status" : 400,
  "title" : "Bad Request",
  "detail" : "Validation failed",
  "errors" : [ {
    "field" : "email",
    "error" : "must be a well-formed email address"
  }, {
    "field" : "age",
    "error" : "must be greater than or equal to 18"
  } ]
}

More notably, for @RequestParam, @RequestHeader etc., there's a tweak that comes from settings configuration property spring.validation.method.adapt-constraint-violations to true. Enabling it, switches default validation to not rely on raw ConstraintViolationException, but rather on MethodValidationException, which contains more details about validated element.

Let's say we have following @RestController, where customerId query param has different Java parameter name (its String customerIdParam). We would like to have customerId in our response body as potential API clients do not have knowledge about internal technologies used by backend.

@Validated
@RestController
static class RequestParamController {
  @GetMapping("/orders")
  String endpoint(@RequestParam("customerId") @Size(min = 5, max = 30) String customerIdParam) {
    return "OK";
  }
}

The .errors[].field will differ, depending on whether spring.validation.method.adapt-constraint-violations is enabled or not. For true it will use value from @RequestParam (if able), and not from Java method argument name (the same goes for @PathVariable, @RequestHeader, @CookieValue etc.).

1. For ConstraintViolationException:

   {
     "status" : 400,
     "title" : "Bad Request",
     "detail" : "Validation failed",
     "errors" : [ {
       "field" : "customerIdParam",
       "error" : "size must be between 5 and 30"
     } ]
   }

2. For MethodValidationException:

   {
     "status" : 400,
     "title" : "Bad Request",
     "detail" : "Validation failed",
     "errors" : [ {
       "field" : "customerId",
       "error" : "size must be between 5 and 30"
     } ]
   }

MethodValidationProblemResolver contains implementation of retrieving configured values from parameter annotations.

---

For Spring Boot versions lower than 3.5, the above-mentioned property is not available and one must configure it programmatically. Consider checking up org.springframework.boot.autoconfigure.validation.ValidationAutoConfiguration and Method Validation Exceptions chapter of Spring Framework documentation.

@Configuration
public class ExampleConfiguration {
  @Bean
  public MethodValidationPostProcessor methodValidationPostProcessor() {
    MethodValidationPostProcessor processor = new MethodValidationPostProcessor();
    processor.setAdaptConstraintViolations(true);
    return processor;
  }
}

Method setAdaptConstraintViolations is available since Spring Framework 6.1 (therefore since Spring Boot 3.2).

---

Similarly, for @ModelAttribute method arguments (object that groups query or form params), violation field names are resolved from @BindParam annotation if present on canonical constructor parameters.