Global Exception Handling Middleware đóng vai trò gì trong kiến trúc ứng dụng web và làm thế nào để phân loại ngoại lệ để trả về mã lỗi HTTP chuẩn xác?

Question

Accepted Answer

Bản chất vấn đề
Trong quá trình vận hành ứng dụng, các ngoại lệ (Exceptions) không mong muốn có thể xảy ra ở bất kỳ tầng nào (Database, Service, Controller). Nếu không có cơ chế bắt lỗi tập trung, ứng dụng sẽ bị sập (Crash) hoặc trả về thông tin ngăn xếp lỗi (Stack Trace) chi tiết cho người dùng, tiềm ẩn nguy cơ lộ lọt thông tin hệ thống.
Cơ chế hoạt động của Global Exception Middleware
Middleware này nằm ở lớp ngoài cùng của request pipeline. Nó sử dụng khối try-catch bao bọc toàn bộ quá trình gọi hàm next() tiếp theo trong chuỗi. Khi có bất kỳ ngoại lệ nào được ném ra từ các tầng bên trong và không được bắt giữ tại chỗ, nó sẽ bay ngược lên đến middleware này.
Phân loại ngoại lệ và chuẩn hóa Response
Để hệ thống chuyên nghiệp, chúng ta nên định nghĩa các custom exception class:

NotFoundError (Mã HTTP 404): Khi không tìm thấy tài nguyên trong Database.
ValidationError (Mã HTTP 422): Khi dữ liệu đầu vào không đúng định dạng nghiệp vụ.
UnauthorizedError (Mã HTTP 401): Khi thiếu hoặc sai token xác thực.
InternalServerError (Mã HTTP 500): Lỗi hệ thống không xác định (Database sập, lỗi code).

Ví dụ triển khai mẫu
function globalErrorHandlerMiddleware(err, req, res, next) {
  const statusCode = err.statusCode || 500;
  const message = err.message || 'Internal Server Error';

// Ghi log chi tiết lỗi nội bộ để lập trình viên gỡ lỗi
  console.error(`[Error] ${new Date().toISOString()} - ${err.stack}`);

res.status(statusCode).json({
    success: false,
    error: {
      code: statusCode,
      message: message,
      // Chỉ hiển thị stack trace ở môi trường development
      stack: process.env.NODE_ENV === 'development' ? err.stack : undefined
    }
  });
}
Kinh nghiệm thực chiến
Không bao giờ được trả nguyên vẹn Stack Trace ra môi trường Production vì hacker có thể dựa vào đó để khai thác lỗ hổng phiên bản framework hoặc cấu trúc mã nguồn.

Global Exception Handling Middleware đóng vai trò gì trong kiến trúc ứng dụng web và làm thế nào để phân loại ngoại lệ để trả về mã lỗi HTTP chuẩn xác?

Bản chất vấn đề

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 layering & middleware liên quan cùng chủ đề