Vì sao xử lý lỗi thường gặp trong ASP.NET lại quan trọng?
Nhìn lại các dự án bên mình từng triển khai, chúng tôi nhận ra một điều khá rõ. Phần lớn thời gian của lập trình viên không nằm ở việc viết tính năng mới mà nằm ở việc tìm xem vì sao ứng dụng đang chạy sai. Ai làm với .NET lâu năm chắc cũng từng có cảm giác này, khi cả buổi chiều trôi qua mà vẫn chưa biết lỗi nằm ở đâu.
Một lỗi nhỏ trong pipeline của ASP.NET có thể khiến cả trang web trả về mã 500. Thông báo thường rất chung chung, chỉ là một dòng quen thuộc trên trình duyệt. Nếu không có quy trình đọc log và khoanh vùng, việc tìm nguyên nhân dễ kéo dài hàng giờ. Nói cách khác, kỹ năng xử lý lỗi thực chất là kỹ năng đọc dấu vết của hệ thống.
Bài này tổng hợp những lỗi chúng tôi gặp nhiều nhất khi triển khai và bảo trì hệ thống .NET. Với mỗi lỗi, bạn sẽ thấy nguyên nhân hay gặp, cách kiểm tra và hướng khắc phục. Phần lớn các bước đều áp dụng được ngay trong dự án hiện tại mà không cần thay đổi kiến trúc lớn.
Lỗi 500 Internal Server Error và cách khoanh vùng
Đây thường là lỗi đầu tiên bạn gặp khi làm việc với ASP.NET. Mã 500 chỉ cho biết máy chủ đã gặp sự cố, nhưng không nói sự cố nằm ở đâu. Vì vậy bước đầu tiên luôn là bật hiển thị chi tiết lỗi trong môi trường phát triển.
Bạn kiểm tra file appsettings.Development.json và đảm bảo mức logging đang ở Debug. Sau đó mở cửa sổ Output của Visual Studio, hoặc mở file log trên máy chủ. Stack trace thường chỉ ra đúng dòng code gây lỗi, và đó là điểm xuất phát tốt nhất để điều tra.
Có một tình huống bên mình từng gặp ở một dự án thương mại điện tử. Hệ thống chỉ trả về 500 khi khách hàng áp dụng mã giảm giá. Lúc đầu cả nhóm nghi ngờ tầng thanh toán, thậm chí đã định rà lại toàn bộ luồng. Đọc log xong mới thấy nguyên nhân nằm ở một giá trị null bị truy cập mà không kiểm tra trước. Chỉ cần thêm điều kiện kiểm tra, lỗi biến mất hoàn toàn. Bài học rút ra là đừng đoán mò, hãy để log dẫn bạn tới nguyên nhân.
Xử lý NullReferenceException một cách có hệ thống
NullReferenceException là lỗi phổ biến nhất khi viết C#. Không ít lập trình viên có thói quen bọc cả đoạn code trong try-catch để lỗi không bung ra ngoài. Cách này chỉ giấu lỗi đi chứ không giải quyết nguyên nhân. Khi lỗi quay lại ở một chỗ khác, việc truy vết sẽ khó hơn nhiều.
Cách tốt hơn là kiểm tra null ngay tại điểm có khả năng xảy ra. Bạn có thể dùng toán tử ?. để truy cập an toàn. Toán tử ?? giúp gán giá trị mặc định khi cần. Ngoài ra, nên bật nullable reference types để trình biên dịch cảnh báo sớm, ngay lúc bạn đang viết code.
Chúng tôi thường khuyến nghị đội ngũ áp dụng vài thói quen cụ thể. Đầu tiên là bật Nullable trong file csproj để nhận cảnh báo khi một biến có khả năng null. Tiếp theo là dùng ?. với những đối tượng bạn không chắc chắn tồn tại. Cuối cùng, đặt ArgumentNullException.ThrowIfNull ở đầu phương thức nhận tham số từ bên ngoài để lỗi được báo đúng nơi.
Khi làm đều đặn, số lỗi runtime giảm rõ rệt. Phần lớn lỗi được phát hiện ngay lúc viết code, thay vì để tới khi người dùng báo lỗi trên môi trường thật.
Lỗi kết nối cơ sở dữ liệu với Entity Framework
Lỗi liên quan đến database thường xuất hiện khi đưa ứng dụng từ máy cá nhân lên server. Chuỗi kết nối chạy ổn trên máy bạn có thể sai trên server, vì tên instance khác, quyền truy cập khác hoặc thiếu cấu hình TrustServerCertificate. Đây là chuyện rất hay gặp trong những đợt triển khai đầu tiên.
Bạn nên tách chuỗi kết nối ra khỏi code và đặt trong biến môi trường hoặc secret manager. Khi gặp lỗi, hãy thử kết nối trực tiếp bằng công cụ quản lý database trước khi nghi ngờ code. Cách này giúp xác định nhanh vấn đề nằm ở hạ tầng hay nằm trong ứng dụng, tiết kiệm kha khá thời gian.
Xử lý lỗi xác thực và phân quyền
Lỗi 401 và 403 thường làm người mới bối rối. Khi người dùng đã đăng nhập mà vẫn bị từ chối, nguyên nhân phổ biến nhất là thứ tự middleware sai. UseAuthentication phải được gọi trước UseAuthorization trong pipeline, nếu đảo ngược thì quyền truy cập sẽ không được đánh giá đúng.
Một nguyên nhân khác hay bị bỏ qua là cookie hết hạn, hoặc cấu hình domain không khớp khi ứng dụng chạy sau reverse proxy. Bên mình từng mất gần một ngày để tìm ra lỗi này. Cuối cùng vấn đề nằm ở việc header X-Forwarded-Proto không được xử lý đúng. Ứng dụng hiểu nhầm giao thức, và trình duyệt từ chối cookie.
Ghi log và theo dõi lỗi sau khi triển khai
Khi ứng dụng đã lên production, bạn không thể đặt breakpoint như lúc phát triển. Vì vậy hệ thống log cần đủ thông tin ngay từ đầu. Serilog hoặc logger tích hợp sẵn của ASP.NET đều phù hợp, miễn là bạn ghi đủ ngữ cảnh như mã người dùng, đường dẫn request và mã correlation để nối các sự kiện lại với nhau.
Cần tránh ghi log dữ liệu nhạy cảm như mật khẩu hay thông tin thẻ. Hãy xem lại cách xử lý exception để không nuốt lỗi âm thầm. Trong thực tế, nhiều lỗi khó tìm chỉ vì một khối catch rỗng nằm im suốt nhiều tháng. Nếu muốn hiểu rõ hơn cách làm, bạn có thể đọc thêm các lưu ý về debug và tối ưu mã cho dev .NET để nắm thêm mẹo kiểm tra trước khi lên production.
Kiểm tra hiệu năng khi lỗi liên quan đến timeout
Không phải lỗi nào cũng đến từ sai logic. Có những lỗi thực chất do truy vấn chậm, và biểu hiện ra ngoài là timeout. Khi gặp tình huống này, hãy đếm số truy vấn sinh ra từ một request. Vấn đề N+1 khi dùng Entity Framework là nguyên nhân khá phổ biến, nhất là khi bạn duyệt danh sách và truy cập quan hệ con trong vòng lặp.
Bạn có thể đối chiếu với các sai lầm thường gặp về Entity Framework để nhận ra sớm những mẫu code gây chậm. Bên cạnh đó, cache kết quả của những truy vấn ổn định cũng giúp giảm áp lực lên database đáng kể. Khi cần triển khai, bạn có thể tham khảo mẹo cache kết quả truy vấn để giảm tải database .NET.
Kết luận
Xử lý lỗi thường gặp trong ASP.NET thực chất là một quy trình gồm nhiều bước: đọc đúng log, khoanh vùng nguyên nhân, sửa tận gốc và phòng ngừa cho lần sau. Khi đã quen với quy trình này, các sự cố bớt đáng sợ hơn nhiều, và bạn cũng ít phải thức khuya để săn lỗi.
Nếu bạn đang ở giai đoạn đầu làm với .NET, hãy bắt đầu từ hai thói quen đơn giản: bật log chi tiết khi phát triển và kiểm tra null có chủ đích thay vì bọc try-catch. Theo kinh nghiệm của chúng tôi, hai việc này đã giải quyết được phần lớn sự cố mà đội ngũ từng gặp.


