Trong ASP.NET Core, làm thế nào để xử lý Global Exception Handling một cách chuyên nghiệp nhằm trả về định dạng lỗi chuẩn hóa cho client và ghi log đầy đủ mà không làm gián đoạn trải nghiệm người dùng?

Question

Accepted Answer

Để xử lý ngoại lệ toàn cục (Global Exception Handling) trong ASP.NET Core theo tiêu chuẩn Enterprise, chúng ta cần đảm bảo hai yếu tố cốt lõi: trả về cấu trúc lỗi JSON đồng nhất cho Client (ví dụ theo chuẩn RFC 7807 Problem Details) và ghi lại vết lỗi (Logging) kèm theo mã định danh (Trace ID/Correlation ID) để đội ngũ vận hành dễ dàng tra cứu. 1. Giải pháp chuẩn mực: Sử dụng IExceptionHandler (ASP.NET Core 8+) Từ phiên bản .NET 8, Microsoft đã giới thiệu interface IExceptionHandler để đơn giản hóa việc xử lý ngoại lệ tập trung mà không cần phụ thuộc hoàn toàn vào các middleware phức tạp. Bước 1: Triển khai IExceptionHandler using Microsoft.AspNetCore.Diagnostics; using Microsoft.AspNetCore.Mvc; public class GlobalExceptionHandler : IExceptionHandler { private readonly ILogger _logger; public GlobalExceptionHandler(ILogger logger) { _logger = logger; } public async ValueTask TryHandleAsync( HttpContext httpContext, Exception exception, CancellationToken cancellationToken) { var traceId = httpContext.TraceIdentifier; _logger.LogError(exception, "Đã xảy ra lỗi không mong muốn. TraceId: {TraceId}", traceId); var (statusCode, title) = exception switch { KeyNotFoundException => (StatusCodes.Status404NotFound, "Không tìm thấy tài nguyên yêu cầu"), UnauthorizedAccessException => (StatusCodes.Status401Unauthorized, "Không có quyền truy cập"), ArgumentException => (StatusCodes.Status400BadRequest, "Dữ liệu đầu vào không hợp lệ"), _ => (StatusCodes.Status500InternalServerError, "Lỗi máy chủ nội bộ") }; httpContext.Response.StatusCode = statusCode; var problemDetails = new ProblemDetails { Status = statusCode, Title = title, Detail = exception.Message, Instance = httpContext.Request.Path, Type = $"https://httpstatuses.com/{statusCode}" }; problemDetails.Extensions["traceId"] = traceId; await httpContext.Response.WriteAsJsonAsync(problemDetails, cancellationToken); return true; // Báo hiệu ngoại lệ đã được xử lý xong } } Bước 2: Đăng ký trong Program.cs builder.Services.AddExceptionHandler(); builder.Services.AddProblemDetails(); var app = builder.Build(); app.UseExceptionHandler(); 2. Các phương án thay thế (Legacy hoặc Middleware tùy chỉnh) UseExceptionHandler Middleware (Minimal API / .NET 6-7): Sử dụng app.UseExceptionHandler(exceptionHandlerApp => { ... }) để bóc tách luồng lỗi, tuy nhiên cách viết này thường khó bảo trì hơn so với IExceptionHandler riêng biệt. Custom Middleware: Viết một Middleware thủ công bắt khối try-catch toàn cục bọc lấy await _next(context). Cách này linh hoạt nhưng dễ làm gián đoạn các tính năng phản hồi luồng như Response Streaming nếu không cẩn thận. 3. Lưu ý kinh nghiệm thực chiến Bảo mật thông tin lỗi: Tuyệt đối không trả về Stack Trace chi tiết (exception.StackTrace) ra môi trường Production vì điều này tạo lỗ hổng bảo mật giúp hacker khai thác cấu trúc hệ thống. Sử dụng Correlation ID / Trace ID: Luôn đưa TraceIdentifier hoặc Correlation ID vào thông điệp lỗi trả về cho client để khi khách hàng báo lỗi, kỹ thuật viên có thể dùng mã đó tra cứu chính xác dòng log tương ứng trên hệ thống Centralized Logging. Kết hợp với FluentValidation: Đối với các lỗi validate dữ liệu đầu vào từ client, nên xử lý riêng ở tầng Filter hoặc Pipeline Validation (trả về status 400 kèm chi tiết lỗi từng trường) thay vì để dồn xuống Global Exception Handler.

Trong ASP.NET Core, làm thế nào để xử lý Global Exception Handling một cách chuyên nghiệp nhằm trả về định dạng lỗi chuẩn hóa cho client và ghi log đầy đủ mà không làm gián đoạn trải nghiệm người dùng?

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 asp.net liên quan cùng chủ đề