Global undantagshantering med @ControllerAdvice
Centralisera undantagshanteringen för alla styrenheter med @ExceptionHandler och @ControllerAdvice.
Global undantagshantering med @ControllerAdvice är en gratis lektion i Java Academy på CoddyKit. Detta är lektion 3 av 4. Ni kan läsa hela lektionen gratis nedan och sedan öva praktiskt i webbläsaren med en inbyggd kodredigerare och en AI-handledare som är tillgänglig dygnet runt. Den ingår i lärvägen för Java Academy, och Era framsteg synkroniseras mellan webben och CoddyKit-appen. Kursen i Java Academy innehåller totalt 4 lektioner.
Problemet utan global felhantering
Utan global undantagshantering behöver varje controller-metod try-catch-block, skapandet av felsvar dupliceras och undantagsdetaljer läcker ut till klienterna.
@ControllerAdvice och @RestControllerAdvice
@ControllerAdvice definierar en klass för global undantagshantering. @RestControllerAdvice lägger till @ResponseBody, så att alla hanterarmetoder automatiskt returnerar JSON.
@RestControllerAdvice
public class GlobalExceptionHandler {
// @ExceptionHandler methods go here
}Metoder med @ExceptionHandler
Annotera en metod med @ExceptionHandler(ExceptionType.class). Spring dirigerar undantag av den typen (och undertyper) till metoden. Returnera en ResponseEntity med lämplig status.
@ExceptionHandler(ResourceNotFoundException.class)
public ResponseEntity<ErrorResponse> handleNotFound(ResourceNotFoundException ex) {
return ResponseEntity.status(HttpStatus.NOT_FOUND)
.body(new ErrorResponse("NOT_FOUND", ex.getMessage()));
}Hantera flera undantagstyper
Lista flera undantagstyper i samma hanterare eller använd en gemensam basklass. Spring väljer den mest specifika tillgängliga hanteraren.
@ExceptionHandler({IllegalArgumentException.class, IllegalStateException.class})
public ResponseEntity<ErrorResponse> handleBadRequest(RuntimeException ex) {
return ResponseEntity.badRequest()
.body(new ErrorResponse("BAD_REQUEST", ex.getMessage()));
}Hantera valideringsfel
Fånga MethodArgumentNotValidException för att extrahera fältnivåfel från begärandekroppar som har validerats med @Valid.
@ExceptionHandler(MethodArgumentNotValidException.class)
public ResponseEntity<Map<String, Object>> handleValidation(MethodArgumentNotValidException ex) {
Map<String, String> fieldErrors = new LinkedHashMap<>();
ex.getBindingResult().getFieldErrors().forEach(e ->
fieldErrors.put(e.getField(), e.getDefaultMessage()));
return ResponseEntity.badRequest()
.body(Map.of("errors", fieldErrors, "status", 400));
}Hantera constraint-överträdelser
ConstraintViolationException kastas när metodparametrar valideras med @Validated på servicelagret. Hantera detta separat från MVC-valideringsfel.
@ExceptionHandler(ConstraintViolationException.class)
public ResponseEntity<Map<String, String>> handleConstraint(ConstraintViolationException ex) {
Map<String, String> errors = new LinkedHashMap<>();
ex.getConstraintViolations().forEach(v ->
errors.put(v.getPropertyPath().toString(), v.getMessage()));
return ResponseEntity.badRequest().body(errors);
}Åtkomst till HttpServletRequest
Lägg till HttpServletRequest som parameter för att få information om begäran (URL, metod och headers) för loggning eller inkludering i felsvaret.
@ExceptionHandler(Exception.class)
public ResponseEntity<ErrorResponse> handleAll(Exception ex, HttpServletRequest req) {
log.error("Unhandled error on {} {}", req.getMethod(), req.getRequestURI(), ex);
return ResponseEntity.internalServerError()
.body(new ErrorResponse("INTERNAL_ERROR", "Unexpected error"));
}@ResponseStatus på undantagsklasser
Annotera anpassade undantagsklasser med @ResponseStatus för att automatiskt ange HTTP-statusen utan en hanterarmetod – enklare i okomplicerade fall.
@ResponseStatus(HttpStatus.NOT_FOUND)
public class ResourceNotFoundException extends RuntimeException {
public ResourceNotFoundException(String msg) { super(msg); }
}Begränsa @ControllerAdvice
Begränsa advice till specifika paket, annoteringar eller basklasser med hjälp av attribut på @ControllerAdvice.
@RestControllerAdvice(basePackages = "com.example.api")
public class ApiExceptionHandler { ... }
@RestControllerAdvice(assignableTypes = {UserController.class, OrderController.class})
public class SpecificHandler { ... }Loggning i undantagshanterare
Logga undantag på lämplig nivå: användarfel (4xx) på WARN-nivå och oväntade fel (5xx) på ERROR-nivå med hela stacktracen.
@ExceptionHandler(Exception.class)
public ResponseEntity<ErrorResponse> handleAll(Exception ex, HttpServletRequest req) {
if (ex instanceof BusinessException) log.warn("Business error: {}", ex.getMessage());
else log.error("Unexpected error on {}", req.getRequestURI(), ex);
return ...
}Prioritet för undantagshanterare
Spring väljer den mest specifika hanteraren. Om ResourceNotFoundException extends RuntimeException gäller, prioriteras en hanterare för ResourceNotFoundException framför en för RuntimeException.
Snabbkontroll
Vilken annotation markerar en metod som globalt hanterar en viss undantagstyp?
Sammanfattning
Använd @RestControllerAdvice och @ExceptionHandler för att centralisera felhanteringen. Returnera ResponseEntity med en konsekvent felstruktur. Hantera validering (MethodArgumentNotValidException) och begränsningar (ConstraintViolationException) separat. Logga 4xx som WARN och 5xx som ERROR.
Lär dig Java med en AI-lärare – gratis
Skriv och kör riktig kod i webbläsaren, få omedelbar hjälp av en AI-lärare dygnet runt och fortsätt där du slutade – på webben eller i appen.
- Kurser
- 104
- Lektioner
- 374
Vanliga frågor
Är lektionen ”Global undantagshantering med @ControllerAdvice” gratis?
Ja – hela texten till ”Global undantagshantering med @ControllerAdvice” kan läsas gratis här på webben. Om Ni vill öva interaktivt med en inbyggd kodredigerare och en AI-handledare som är tillgänglig dygnet runt och låsa upp resten av kursen i Java Academy, kan Ni uppgradera till CoddyKit PRO. Kursen i Java Academy innehåller totalt 4 lektioner.
Vad lär jag mig i ”Global undantagshantering med @ControllerAdvice”?
Centralisera undantagshanteringen för alla styrenheter med @ExceptionHandler och @ControllerAdvice. Ni övar på Java Academy med praktisk kod som körs direkt i webbläsaren, medan en AI-handledare som är tillgänglig dygnet runt svarar på Era frågor under lektionen.
Behöver jag någon erfarenhet för att börja lära mig Java Academy?
Du behöver inga förkunskaper. Utbildningen i Java Academy på CoddyKit är upplagd för allt från nybörjare till avancerade elever, så att du kan börja här eller från början och gå fram i din egen takt. Detta är lektion 3 av 4.
Hur lång tid tar lektionen ”Global undantagshantering med @ControllerAdvice”?
De flesta CoddyKit-lektioner tar cirka 5–10 minuter. Varje lektion är kort och interaktiv, så att du gör stadiga framsteg och kan fortsätta precis där du slutade – på webben eller i appen.
Kan jag skriva och köra kod i den här Java Academy-lektionen?
Ja. Varje Java Academy-lektion innehåller en inbyggd kodredigerare, så att du kan skriva och köra riktig kod direkt i webbläsaren och få omedelbar AI-feedback – utan lokal installation.
Alla lektioner i den här kursen
- Bean-validering: @NotNull, @Size, @Pattern
- Anpassade constraint-annotationer
- Global undantagshantering med @ControllerAdvice
- RFC 7807 Problem Details och enhetliga felsvar