Why centralized error handling matters in Spring Boot

Introduction

Centralized error handling helps catch and manage errors in one place. This makes your app easier to fix and keeps it running smoothly.

When you want to show friendly error messages to users instead of technical details.

When you need to log all errors consistently for later review.

When you want to avoid repeating error handling code in many places.

When you want to handle different error types with specific responses.

When you want to keep your code clean and easier to maintain.

Syntax

Spring Boot

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(Exception.class)
    public ResponseEntity<String> handleAllExceptions(Exception ex) {
        // handle error and return response
        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("An error occurred");
    }
}

Use @ControllerAdvice to mark a class for global error handling.

Use @ExceptionHandler to specify which errors to catch.

Examples

This example catches only null pointer errors and returns a 400 status with a message.

Spring Boot

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(NullPointerException.class)
    public ResponseEntity<String> handleNullPointer(NullPointerException ex) {
        return ResponseEntity.status(HttpStatus.BAD_REQUEST).body("Null value found");
    }
}

This example catches all exceptions and returns a generic error message with status 500.

Spring Boot

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(Exception.class)
    public ResponseEntity<String> handleAllExceptions(Exception ex) {
        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("Something went wrong");
    }
}

Sample Program

This global handler catches illegal argument errors and returns a 400 status with a message. It also catches any other exceptions and returns a 500 status with a generic message.

Spring Boot

import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(IllegalArgumentException.class)
    public ResponseEntity<String> handleIllegalArgument(IllegalArgumentException ex) {
        return ResponseEntity.status(HttpStatus.BAD_REQUEST).body("Invalid argument: " + ex.getMessage());
    }

    @ExceptionHandler(Exception.class)
    public ResponseEntity<String> handleAllExceptions(Exception ex) {
        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("Internal server error");
    }
}

Important Notes

Centralized error handling improves user experience by showing clear messages.

It helps developers find and fix bugs faster by logging errors in one place.

Remember to handle specific exceptions before the general Exception class to avoid masking errors.

Summary

Centralized error handling catches errors in one place for easier management.

It helps show friendly messages and keeps code clean.

Use @ControllerAdvice and @ExceptionHandler in Spring Boot for this.

Practice

1. Why is centralized error handling important in a Spring Boot application?

easy

A. It requires writing error handling code in every controller separately.

B. It automatically fixes all bugs without developer intervention.

C. It allows handling all exceptions in one place for cleaner code and easier maintenance.

D. It disables error messages to users for security reasons.

Solution

1. Step 1: Understand centralized error handling purpose

   Centralized error handling groups exception logic in one place, avoiding repetition.

2. Step 2: Compare with other options

   Options B and C are incorrect because errors are not fixed automatically, and error messages can be customized but not disabled by default. It requires writing error handling code in every controller separately. is incorrect because centralized handling avoids writing error code in every controller separately.

3. Final Answer:

   It allows handling all exceptions in one place for cleaner code and easier maintenance. -> Option C

4. Quick Check:

   Centralized error handling = cleaner, easier maintenance [OK]

Hint: Centralized means one place for all errors [OK]

Common Mistakes:

• Thinking it fixes bugs automatically
• Believing it disables all error messages
• Confusing centralized with duplicated code

2. Which annotation is used in Spring Boot to create a centralized error handler class?

easy

A. @ControllerAdvice

B. @Service

C. @RestController

D. @Repository

Solution

1. Step 1: Identify the annotation for centralized error handling

   @ControllerAdvice is the Spring Boot annotation designed to handle exceptions globally across controllers.

2. Step 2: Eliminate other annotations

   @RestController is for REST endpoints, @Service is for business logic, and @Repository is for data access, none handle errors globally.

3. Final Answer:

   @ControllerAdvice -> Option A

4. Quick Check:

   @ControllerAdvice = centralized error handler [OK]

Hint: Remember: Advice means giving guidance globally [OK]

Common Mistakes:

• Using @RestController for error handling
• Confusing @Service with error handling
• Thinking @Repository handles exceptions

3. Given this Spring Boot code snippet inside a @ControllerAdvice class:

@ExceptionHandler(NullPointerException.class)
public ResponseEntity<String> handleNullPointer() {
    return ResponseEntity.status(HttpStatus.BAD_REQUEST).body("Null value found");
}

What will be the HTTP status code and message when a NullPointerException occurs?

medium

A. 400 Bad Request with message "Null value found"

B. 200 OK with message "Null value found"

C. 500 Internal Server Error with default message

D. 404 Not Found with message "Null value found"

Solution

1. Step 1: Analyze the @ExceptionHandler method

   The method returns ResponseEntity with status BAD_REQUEST (400) and body "Null value found" when NullPointerException occurs.

2. Step 2: Match status and message to options

   400 Bad Request with message "Null value found" matches 400 Bad Request and the custom message. Other options have wrong status codes or messages.

3. Final Answer:

   400 Bad Request with message "Null value found" -> Option A

4. Quick Check:

   @ExceptionHandler sets status 400 and message [OK]

Hint: Check ResponseEntity status for HTTP code [OK]

Common Mistakes:

• Assuming default 500 error instead of custom status
• Confusing 404 Not Found with exception handling
• Ignoring the custom message in response body

4. Consider this @ControllerAdvice class snippet:

@ExceptionHandler(Exception.class)
public ResponseEntity<String> handleAll(Exception ex) {
    return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("Error occurred");
}

Why might this cause problems in a Spring Boot app?

medium

A. It only handles NullPointerExceptions, ignoring other exceptions.

B. It returns 200 OK status instead of error status.

C. It causes syntax errors because @ExceptionHandler cannot handle Exception class.

D. It catches all exceptions, hiding specific error handlers and making debugging harder.

Solution

1. Step 1: Understand broad exception handling impact

   Handling Exception.class catches all exceptions, which can override more specific handlers and hide detailed error info.

2. Step 2: Evaluate other options

   It only handles NullPointerExceptions, ignoring other exceptions. is wrong because it handles all exceptions, not just NullPointerException. It causes syntax errors because @ExceptionHandler cannot handle Exception class. is incorrect; syntax is valid. It returns 200 OK status instead of error status. is wrong; status is 500, not 200.

3. Final Answer:

   It catches all exceptions, hiding specific error handlers and making debugging harder. -> Option D

4. Quick Check:

   Generic Exception handler can hide specific errors [OK]

Hint: Generic handlers override specific ones, use carefully [OK]

Common Mistakes:

• Thinking it only handles NullPointerException
• Believing it causes syntax errors
• Assuming it returns 200 OK status

5. You want to create a centralized error handler that returns different HTTP statuses for different exceptions: 404 for ResourceNotFoundException and 400 for InvalidInputException. Which approach correctly implements this in Spring Boot?

hard

A. Use one @ExceptionHandler method with multiple if-else checks on exception type inside it.

B. Create separate @ExceptionHandler methods for each exception type inside a @ControllerAdvice class.

C. Handle exceptions inside each controller method instead of centralized handling.

D. Use @ControllerAdvice with a single method annotated with @ExceptionHandler(Exception.class) returning 200 OK.

Solution

1. Step 1: Understand best practice for multiple exception types

   Spring Boot recommends separate @ExceptionHandler methods for each exception type to return specific responses clearly.

2. Step 2: Evaluate other options

   Use one @ExceptionHandler method with multiple if-else checks on exception type inside it. is less clean and harder to maintain. Handle exceptions inside each controller method instead of centralized handling. defeats centralized handling purpose. Use @ControllerAdvice with a single method annotated with @ExceptionHandler(Exception.class) returning 200 OK. returns wrong status 200 OK and handles all exceptions generically.

3. Final Answer:

   Create separate @ExceptionHandler methods for each exception type inside a @ControllerAdvice class. -> Option B

4. Quick Check:

   Separate handlers per exception = clear, maintainable [OK]

Hint: One handler per exception type for clarity [OK]

Common Mistakes:

• Using one method with if-else for all exceptions
• Handling errors in controllers, not centralized
• Returning 200 OK for error responses