Skip to content

Xử lý lỗi ​

Trang này mô tả lỗi từ backend đi qua frontend như thế nào, phần nào tự báo cho người dùng và phần nào do từng màn hình tự xử lý. Dành cho developer thêm màn hình mới hoặc tìm hiểu vì sao một lỗi hiện thông báo còn lỗi khác thì không.

Vì sao cần hiểu ​

Lỗi được xử lý ở nhiều tầng. Nếu không biết tầng nào đã làm gì, bạn dễ thêm một thông báo trùng, hoặc ngược lại tưởng đã có thông báo trong khi thật ra chưa.

NOTE

Backend không có bộ lọc lỗi tùy biến: lỗi theo dạng mặc định của NestJS, và message có thể là mảng khi lỗi do kiểm tra dữ liệu. Chi tiết ở tài liệu backend.

Các tầng xử lý ​

Sơ đồ cho thấy middleware chỉ xử lý một số mã chung, còn lại do từng màn hình tự đọc error từ hook.

Dạng lỗi frontend nhận ​

axiosBaseQuery chuyển mọi lỗi của Axios thành đối tượng sau, đây là error mà hook RTK Query trả về:

FieldNguồnÝ nghĩa
statuserr.response?.statusMã HTTP; undefined khi không nhận được phản hồi
dataerr.response?.data hoặc err.messageThân phản hồi lỗi của backend
messageerr.messageThông điệp của Axios, ví dụ Network Error

Tầng 1: Axios interceptor ​

Chỉ lo hai trường hợp, cả hai đều thuộc luồng xác thực:

Trường hợpHành vi
401 trên request không phải đăng nhập hoặc đăng kýChỉ khi request có gửi token: gọi refreshAccessToken() (single-flight); thành công thì gửi lại request gốc
Làm mới token thất bại (người dùng đang có token)session.ts gọi onSessionExpired: dispatch sessionExpired, xóa token và cache RTK Query, ClientLayout chuyển về /login

Việc làm mới dùng axios trần nên lỗi của nó không đi qua interceptor; nhánh 400 trên /auth/refresh vì vậy chỉ chạy khi có request qua axiosInstance tới đúng đường dẫn đó. Chi tiết và các điểm cần chạy thử xem Xác thực.

Tầng 2: authErrorMiddleware ​

Middleware bắt các action RTK Query bị từ chối:

Điều kiệnHành vi
status === 403Toast lỗi, ưu tiên data.message, nếu không có thì dùng chuỗi middleware.forbidden
status === 500Toast lỗi, ưu tiên data.message, nếu không có thì dùng chuỗi middleware.serverError
message chứa Network ErrorToast middleware.networkError

Toast được gắn id để không hiện lặp. Ngoài ra middleware không xử lý 401 hay các mã khác.

WARNING

Middleware đoán ngôn ngữ bằng cách lấy đoạn đầu của đường dẫn và chỉ nhận vi hoặc en, nếu không thì dùng vi. Vì tiếng Anh là ngôn ngữ mặc định và không có tiền tố URL, người dùng đang xem bản tiếng Anh sẽ nhận các toast chung này bằng tiếng Việt. Đây là hiện trạng của code, chưa có ghi chép về lý do.

Tầng 3: từng màn hình ​

Màn hình tự đọc lỗi từ hook và quyết định thông báo. Mẫu thường gặp là lấy error?.data?.message, rồi error?.message, rồi chuỗi dịch làm giá trị dự phòng; mẫu này xuất hiện ở khoảng 26 file.

ts
// src/app/[locale]/(auth)/login/page.tsx (rút gọn)
const errorMessage =
  error?.data?.message ||
  error?.message ||
  t("authModal.toasts.loginFailedFallback");
toast.error(errorMessage);

Vì message của backend có thể là mảng, giá trị này không phải lúc nào cũng là chuỗi. Chưa kiểm tra từng màn hình xem có xử lý trường hợp mảng hay không.

Lỗi ở lời gọi phía server ​

Các hàm fetchPublic* không ném lỗi. Khi backend trả mã không thành công hoặc mất kết nối, chúng trả về null, và trang xử lý như không có dữ liệu. Không có toast ở đây vì trang chưa chạy trên trình duyệt.

Nơi gọiKhi lỗiKết quả với người dùng
RTK Query trên trình duyệterror trong hookTùy từng màn hình, cộng với toast chung ở tầng 2
fetchPublic* trên serverTrả nullTrang hiển thị như không có dữ liệu

Source code liên quan ​

Đọc tiếp: Quy ước API, Xác thực, Giao tiếp API.

Tài liệu kỹ thuật xây dựng theo chuẩn Documentation as Code