Iniciar sesión

Errores en un solo lugar en Spring Boot

@RestControllerAdvice y los errores de validación

Unidad: Validación y manejo de errores Gratis
🧭
Errores en un solo lugar
Un @ExceptionHandler dentro de un controlador solo atiende las excepciones de ese controlador. Para manejarlas en todos, se juntan en una clase con @RestControllerAdvice.
@RestControllerAdvice class ManejoDeErrores { @ExceptionHandler(PedidoNoEncontrado.class) ResponseEntity<String> noExiste( PedidoNoEncontrado e) { return ResponseEntity.status(404) .body(e.getMessage()); } }
Si dos manejadores de la misma clase sirven, gana el de la excepción más específica: con uno para RuntimeException y otro para IllegalArgumentException, esta última va al segundo. Y si el controlador tiene su propio @ExceptionHandler, ese le gana al del advice.
Cuando falla @Valid, Spring lanza MethodArgumentNotValidException. Su getBindingResult().getFieldErrors() trae un error por campo: getField() es el nombre y getDefaultMessage() tu message.
@ExceptionHandler( MethodArgumentNotValidException.class) ResponseEntity<Map<String, String>> invalido( MethodArgumentNotValidException e) { var errores = new TreeMap<String, String>(); for (var f : e.getBindingResult().getFieldErrors()) errores.put(f.getField(), f.getDefaultMessage()); return ResponseEntity.badRequest().body(errores); } // 400 {"cantidad":"la cantidad debe ser positiva", // "producto":"falta el producto"}
Dos trampas: un manejador que devuelve un String sin @ResponseStatus responde 200, aunque haya sido un error. Y uno para RuntimeException atrapa también las excepciones que ya tenían su código y los errores de reglas en un @RequestParam o @PathVariable: todo termina en 500. Nunca mandes al cliente el stack trace (la lista de métodos por donde pasó el error).

Pon a prueba lo que aprendiste

Concepto

¿Qué hace una clase con @RestControllerAdvice?

  1. AValida los datos antes de que lleguen a Spring
  2. BManeja excepciones de todos los controladores
  3. CDa consejos de diseño al compilar la app
  4. DAtiende las rutas que no tiene ningún controlador
Ver respuesta
B) Maneja excepciones de todos los controladores Es el lugar central para los errores.
Trazar código

uno lanza new PedidoNoEncontrado(id) si no existe el pedido. Un @RestControllerAdvice tiene este manejador. ¿Qué responde GET /pedidos/9?

class PedidoNoEncontrado extends RuntimeException { PedidoNoEncontrado(int id) { super("No existe el pedido " + id); } } @ExceptionHandler(PedidoNoEncontrado.class) ResponseEntity<String> noExiste( PedidoNoEncontrado e) { return ResponseEntity.status(404) .body(e.getMessage()); }
  1. A500 No existe el pedido 9
  2. B404 y el JSON de error de Spring
  3. C404 No existe el pedido 9
  4. D200 No existe el pedido 9
Ver respuesta
C) 404 No existe el pedido 9 El advice atrapa la excepción de cualquier controlador.
Trazar código

El advice tiene estos dos manejadores. GET /pagos/9000 lanza new IllegalArgumentException("monto muy alto"). ¿Qué responde?

@ExceptionHandler(RuntimeException.class) ResponseEntity<String> general( RuntimeException e) { return ResponseEntity.status(500) .body("error general"); } @ExceptionHandler( IllegalArgumentException.class) ResponseEntity<String> argumento( IllegalArgumentException e) { return ResponseEntity.badRequest() .body(e.getMessage()); }
  1. A400 error general
  2. B500 y el JSON de error de Spring
  3. C500 error general
  4. D400 monto muy alto
Ver respuesta
D) 400 monto muy alto Gana el manejador más específico.

Practica esta lección completa

Ejercicios de completar código, ordenar bloques y respuesta libre. Ganas XP y mantienes tu racha.

Practicar gratis, sin registrarte Entras como invitado directo a esta lección. Sin tarjeta.