Trong hệ thống Spring Boot Enterprise, việc xử lý ngoại lệ (Exception Handling) đồng bộ và nhất quán trên toàn bộ các REST APIs là tiêu chuẩn bắt buộc. Hãy thiết kế một Global Exception Handler chuẩn mực sử dụng @ControllerAdvice và phân tích cách quản lý mã lỗi, thông báo lỗi đa ngôn ngữ (i18n) cũng như ghi log bảo mật?

Question

Accepted Answer

Một hệ thống Enterprise chất lượng cao không bao giờ được phép trả về trang lỗi HTML mặc định của Tomcat hoặc các cấu trúc JSON lỗi khác nhau từ các service khác nhau khi có Exception xảy ra. 1. Kiến trúc Global Exception Handler Spring Boot cung cấp annotation @RestControllerAdvice cho phép bắt tất cả các ngoại lệ văng ra từ tầng Controller, xử lý và chuẩn hóa chúng thành một cấu trúc Response thống nhất. 2. Thiết kế Error Response Chuẩn Mực Một cấu trúc JSON Error Response tiêu chuẩn thường bao gồm: Timestamp: Thời điểm xảy ra lỗi. Status: Mã HTTP Status code (ví dụ: 400, 404, 500). Error: Tên loại lỗi. Message: Thông điệp mô tả chi tiết cho client. Path: Đường dẫn API gây ra lỗi. Details: Danh sách các lỗi chi tiết (thường dùng cho trường hợp Validate dữ liệu Form). 3. Ví dụ cài đặt thực tế @RestControllerAdvice public class GlobalExceptionHandler { private static final Logger log = LoggerFactory.getLogger(GlobalExceptionHandler.class); @ExceptionHandler(ResourceNotFoundException.class); public ResponseEntity handleResourceNotFoundException( ResourceNotFoundException ex, WebRequest request) { ErrorResponse error = new ErrorResponse( LocalDateTime.now(), HttpStatus.NOT_FOUND.value(), "Not Found", ex.getMessage(), request.getDescription(false).replace("uri=", "") ); return new ResponseEntity<>(error, HttpStatus.NOT_FOUND); } @ExceptionHandler(MethodArgumentNotValidException.class); public ResponseEntity handleValidationExceptions( MethodArgumentNotValidException ex, WebRequest request) { Map errors = new HashMap<>(); ex.getBindingResult().getAllErrors().forEach((error) -> { String fieldName = ((FieldError) error).getField(); String errorMessage = error.getDefaultMessage(); errors.put(fieldName, errorMessage); }); ValidationErrorResponse error = new ValidationErrorResponse( LocalDateTime.now(), HttpStatus.BAD_REQUEST.value(), "Validation Failed", "Dữ liệu đầu vào không hợp lệ", request.getDescription(false).replace("uri=", ""), errors ); return new ResponseEntity<>(error, HttpStatus.BAD_REQUEST); } @ExceptionHandler(Exception.class); public ResponseEntity handleGlobalException( Exception ex, WebRequest request) { // Ghi log toàn bộ StackTrace ở cấp độ ERROR phục vụ debug nội bộ log.error("Đã xảy ra lỗi hệ thống không xác định: ", ex); ErrorResponse error = new ErrorResponse( LocalDateTime.now(), HttpStatus.INTERNAL_SERVER_ERROR.value(), "Internal Server Error", "Đã có lỗi hệ thống xảy ra, vui lòng thử lại sau.", request.getDescription(false).replace("uri=", "") ); return new ResponseEntity<>(error, HttpStatus.INTERNAL_SERVER_ERROR); } } 4. Lưu ý quan trọng về Bảo mật và Vận hành (Best Practices) Không trả về StackTrace cho Client: Tuyệt đối không đưa nội dung chi tiết của ex.printStackTrace() hoặc ex.getMessage() gốc của các lỗi hệ thống (như NullPointerException, Database Connection Error) ra bên ngoài client vì sẽ lộ cấu trúc mã nguồn. Bảo mật thông tin trong Log: Không ghi log các thông tin nhạy cảm như Password, Token, Credit Card Number khi log lại ngoại lệ. Tích hợp i18n: Sử dụng MessageSource kết hợp với LocaleContextHolder để trả về thông báo lỗi bằng ngôn ngữ tương ứng với Header Accept-Language mà phía Client gửi lên.

Mở Khóa Full Câu Trả Lời & Code Chuẩn Senior

Làm Chủ Phỏng Vấn & Nâng Cao Trình Độ Chuyên Nghiệp

Tải Tuyển Tập 100+ Câu Hỏi Phỏng Vấn Chuyên Sâu (PDF)

Cần Mentor Phỏng Vấn Thử 1-1 & Tối Ưu CV?

Kiểm Tra CV Chuẩn ATS Miễn Phí

Câu hỏi Spring Boot liên quan cùng chủ đề