Spring Boot 3.x — @RestControllerAdvice not catching custom exceptions

Question

I recently upgraded to Spring Boot 3.5 (Jakarta packages) and noticed my global exception handler isn’t being triggered.

@RestController
public class UserController {
    @GetMapping("/test")
    public String test() {
        throw new MyBusinessException("Something went wrong");
    }
}

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(MyBusinessException.class)
    public ProblemDetail handleMyBusinessException(MyBusinessException ex) {
        return ProblemDetail.forStatusAndDetail(HttpStatus.BAD_REQUEST, ex.getMessage());
    }
}

public class MyBusinessException extends RuntimeException {
    public MyBusinessException(String message) { super(message); }
}

When I call /test, I still get the default 500 response instead of my custom ProblemDetail.

I’ve verified:

Packages are under the same base package.
Using jakarta.* imports.
No custom filters or resolvers.

Question: Why isn’t my @RestControllerAdvice handler being called in Spring Boot 3.x, and how can I fix it so it returns my custom JSON response?

how are you triggering UserController::test method? in test or via postman/curl? If in test, show your test code please — asgarov1
– asgarov1, Commented Oct 27 at 7:41

NotTheDr01ds · Accepted Answer · 2025-11-09 23:55:12Z

-2

@RestControllerAdvice
@Component // Explicitly mark as a component
public class GlobalExceptionHandler {
    // ... your handler method
}

The most likely fix is ensuring proper package scanning or explicitly marking GlobalExceptionHandler as a component. After addressing these, your @RestControllerAdvice should catch MyBusinessException and return the custom ProblemDetail

edited Nov 9 at 23:55

NotTheDr01ds

21.8k8 gold badges66 silver badges96 bronze badges

answered Oct 27 at 6:21

spring summer

201 bronze badge

Sign up to request clarification or add additional context in comments.

1 Comment

M. Deinum Oct 28 at 9:59

@RestControllerAdvice is already an @Component adding the annotation won't solve a thing only will add clutter.

Collectives™ on Stack Overflow

Spring Boot 3.x — @RestControllerAdvice not catching custom exceptions

1 Answer 1

1 Comment

Your Answer

Hot Network Questions

Collectives™ on Stack Overflow

1 Answer 1

1 Comment

Your Answer

Sign up or log in

Post as a guest

Related