Validation error responses in Spring Boot

Introduction

Validation error responses tell users what went wrong when they send wrong or incomplete data. This helps users fix their input easily.

When a user submits a form with missing or wrong information.

When an API receives data that does not meet the required rules.

When you want to give clear feedback about input mistakes.

When you want to prevent bad data from being saved or processed.

Syntax

Spring Boot

@RestController
public class MyController {

    @PostMapping("/submit")
    public ResponseEntity<String> submitData(@Valid @RequestBody MyData data, BindingResult result) {
        if (result.hasErrors()) {
            // handle errors
        }
        return ResponseEntity.ok("Success");
    }

    @ExceptionHandler(MethodArgumentNotValidException.class)
    public ResponseEntity<Map<String, String>> handleValidationExceptions(MethodArgumentNotValidException ex) {
        Map<String, String> errors = new HashMap<>();
        ex.getBindingResult().getFieldErrors().forEach(error ->
            errors.put(error.getField(), error.getDefaultMessage()));
        return ResponseEntity.badRequest().body(errors);
    }
}

Use @Valid to trigger validation on input data.

Use @ExceptionHandler to catch validation errors and send a clear response.

Examples

Simple check for errors inside the controller method.

Spring Boot

@PostMapping("/user")
public ResponseEntity<String> addUser(@Valid @RequestBody User user, BindingResult result) {
    if (result.hasErrors()) {
        return ResponseEntity.badRequest().body("Invalid user data");
    }
    return ResponseEntity.ok("User added");
}

Centralized error handler that returns field-specific messages.

Spring Boot

@ExceptionHandler(MethodArgumentNotValidException.class)
public ResponseEntity<Map<String, String>> handleErrors(MethodArgumentNotValidException ex) {
    Map<String, String> errors = new HashMap<>();
    ex.getBindingResult().getFieldErrors().forEach(error ->
        errors.put(error.getField(), error.getDefaultMessage()));
    return ResponseEntity.badRequest().body(errors);
}

Sample Program

This Spring Boot controller accepts a user with a name. If the name is blank, it sends back a clear error message in JSON format.

Spring Boot

import jakarta.validation.constraints.NotBlank;
import org.springframework.http.ResponseEntity;
import org.springframework.validation.FieldError;
import org.springframework.web.bind.MethodArgumentNotValidException;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;
import jakarta.validation.Valid;
import java.util.HashMap;
import java.util.Map;

@RestController
public class UserController {

    public static class User {
        @NotBlank(message = "Name must not be blank")
        public String name;
    }

    @PostMapping("/users")
    public ResponseEntity<String> createUser(@Valid @RequestBody User user) {
        return ResponseEntity.ok("User created: " + user.name);
    }

    @ExceptionHandler(MethodArgumentNotValidException.class)
    public ResponseEntity<Map<String, String>> handleValidationErrors(MethodArgumentNotValidException ex) {
        Map<String, String> errors = new HashMap<>();
        for (FieldError error : ex.getBindingResult().getFieldErrors()) {
            errors.put(error.getField(), error.getDefaultMessage());
        }
        return ResponseEntity.badRequest().body(errors);
    }
}

Important Notes

Always add meaningful messages to your validation annotations for better feedback.

Use @ExceptionHandler to keep your controller methods clean and handle errors in one place.

Summary

Validation error responses help users fix their input by telling them what is wrong.

Use @Valid and @ExceptionHandler in Spring Boot to handle validation errors.

Return clear, field-specific messages in JSON for easy understanding.

Practice

1. What is the main purpose of validation error responses in a Spring Boot application?

easy

A. To speed up the application startup time

B. To inform users about incorrect input so they can fix it

C. To log errors only for developers without user feedback

D. To automatically correct user input without notification

Solution

1. Step 1: Understand validation error responses

   Validation error responses are designed to tell users what input is wrong so they can correct it.

2. Step 2: Identify the purpose in Spring Boot context

   Spring Boot uses validation error responses to provide clear feedback to users, improving user experience.

3. Final Answer:

   To inform users about incorrect input so they can fix it -> Option B

4. Quick Check:

   Validation error responses = user input feedback [OK]

Hint: Validation errors help users fix input mistakes [OK]

Common Mistakes:

• Thinking validation errors speed up startup
• Assuming errors are only for developer logs
• Believing errors auto-correct input silently

2. Which annotation is used in Spring Boot to trigger validation on a request body object?

easy

A. @Valid

B. @Autowired

C. @RequestBody

D. @Controller

Solution

1. Step 1: Identify annotation for validation

   The @Valid annotation tells Spring Boot to validate the object passed in the request.

2. Step 2: Differentiate from other annotations

   @RequestBody binds the request body, @Autowired injects dependencies, and @Controller marks a class as a controller, none trigger validation.

3. Final Answer:

   @Valid -> Option A

4. Quick Check:

   Validation trigger = @Valid [OK]

Hint: Use @Valid to activate validation on input objects [OK]

Common Mistakes:

• Confusing @RequestBody with validation trigger
• Using @Autowired for validation incorrectly
• Thinking @Controller triggers validation

3. Given this Spring Boot controller method snippet, what will be the HTTP response status if validation fails?

@PostMapping("/users")
public ResponseEntity<String> createUser(@Valid @RequestBody User user) {
    return ResponseEntity.ok("User created");
}

medium

A. 400 Bad Request

B. 200 OK

C. 500 Internal Server Error

D. 404 Not Found

Solution

1. Step 1: Understand validation failure behavior

   When validation fails on a @Valid annotated object, Spring Boot returns a 400 Bad Request by default.

2. Step 2: Check the method response

   The method returns 200 OK only if validation passes; failure triggers automatic 400 response.

3. Final Answer:

   400 Bad Request -> Option A

4. Quick Check:

   Validation fail status = 400 Bad Request [OK]

Hint: Validation failure returns 400 Bad Request by default [OK]

Common Mistakes:

• Assuming 200 OK even if validation fails
• Thinking validation failure causes 500 error
• Confusing 404 Not Found with validation errors

4. What is wrong with this Spring Boot exception handler for validation errors?

@ExceptionHandler(MethodArgumentNotValidException.class)
public ResponseEntity<String> handleValidationError(MethodArgumentNotValidException ex) {
    return ResponseEntity.badRequest().body(ex.getMessage());
}

medium

A. It does not use @Valid annotation

B. It uses the wrong exception class for validation errors

C. It should return HTTP status 500 instead of 400

D. It returns a plain message string instead of detailed field errors

Solution

1. Step 1: Analyze the exception handler response

   The handler returns only the exception message string, which is not user-friendly or field-specific.

2. Step 2: Understand best practice for validation errors

   Best practice is to return a JSON with detailed field error messages for clarity, not just a plain string.

3. Final Answer:

   It returns a plain message string instead of detailed field errors -> Option D

4. Quick Check:

   Validation error response should be detailed JSON [OK]

Hint: Return detailed JSON, not plain strings, for validation errors [OK]

Common Mistakes:

• Using wrong exception class (MethodArgumentNotValidException is correct)
• Returning HTTP 500 instead of 400
• Confusing @Valid usage with exception handling

5. You want to customize validation error responses to return JSON with field names and messages. Which approach correctly achieves this in Spring Boot?

hard

A. Use @ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR) on the controller method to handle validation errors

B. Add @Valid to the controller method and rely on default error messages without customization

C. Create a @ControllerAdvice class with @ExceptionHandler for MethodArgumentNotValidException that extracts field errors and returns a JSON map

D. Catch Exception in the controller method and return a plain string message

Solution

1. Step 1: Understand how to customize validation error responses

   Using a @ControllerAdvice with an @ExceptionHandler for MethodArgumentNotValidException allows extracting field errors and returning custom JSON.

2. Step 2: Evaluate other options

   Add @Valid to the controller method and rely on default error messages without customization uses default messages without customization; C uses wrong status; D returns plain string, not JSON.

3. Final Answer:

   Create a @ControllerAdvice class with @ExceptionHandler for MethodArgumentNotValidException that extracts field errors and returns a JSON map -> Option C

4. Quick Check:

   Custom JSON errors = @ControllerAdvice + @ExceptionHandler [OK]

Hint: Use @ControllerAdvice and @ExceptionHandler for custom JSON errors [OK]

Common Mistakes:

• Relying on default messages without customization
• Using wrong HTTP status for validation errors
• Returning plain strings instead of JSON