Xử lý Ngoại lệ Tùy chỉnh & Chuẩn hóa Error Response (Custom Exception Handling & Error Envelope)

Mục tiêu kiến thức

• Định nghĩa Custom Exception trong Python.
• Đăng ký @app.exception_handler trong FastAPI để bắt lỗi và trả về JSON chuẩn hóa (Error Envelope) thay vì cấu trúc mặc định.

Mô tả bài toán

• Định nghĩa lớp ngoại lệ:

   class EntityNotFoundException(Exception):
       def __init__(self, entity_name: str, entity_id: int):
           self.entity_name = entity_name
           self.entity_id = entity_id

• Viết hàm create_app_with_exception_handler() -> FastAPI:
• Đăng ký @app.exception_handler(EntityNotFoundException):

Khi ngoại lệ này xuất hiện, trả về JSONResponse:

• status_code = 404
• content:

       {
           "success": false,
           "error_code": "ENTITY_NOT_FOUND",
           "message": f"Entity '{exc.entity_name}' with ID {exc.entity_id} was not found"
       }

• Tạo endpoint GET /users/{user_id}:
• Nếu user_id == 1: trả về {"success": True, "data": {"id": 1, "name": "Admin"}}.
• Nếu user_id != 1: raise EntityNotFoundException(entity_name="User", entity_id=user_id).

Ràng buộc

• Thời gian chạy tối đa: 1000ms.
• Giới hạn bộ nhớ: 256MB.
• Dữ liệu đầu vào tuân thủ đúng kiểu dữ liệu và miền giá trị được mô tả.