Tra cứu mã trạng thái HTTP

Tra cứu bất kỳ mã trạng thái HTTP nào — 200, 404, 500 và mọi mã ở giữa — cùng lời giải thích dễ hiểu về ý nghĩa và thời điểm máy chủ trả về mã đó.

Tra cứu mã trạng thái HTTP là gì?

Mã trạng thái HTTP là các số có ba chữ số mà máy chủ web gửi kèm mỗi phản hồi, cho client (trình duyệt, ứng dụng hoặc bên tiêu thụ API) biết yêu cầu đã thành công, cần chuyển hướng, hay thất bại — và vì sao. Chúng được IETF chuẩn hóa và dùng giống hệt nhau trên mọi máy chủ web, trình duyệt và ngôn ngữ lập trình, khiến chúng trở thành một trong những tài liệu tham khảo gỡ lỗi phổ quát nhất trong phát triển phần mềm.

Công cụ tra cứu này bao quát các mã thường gặp nhất thuộc cả năm nhóm — thông tin (1xx), thành công (2xx), chuyển hướng (3xx), lỗi client (4xx) và lỗi máy chủ (5xx) — kèm giải thích dễ hiểu về ý nghĩa thực tế của từng mã, không chỉ định nghĩa hình thức trong RFC.

Công Thức

1xx: Thông tin — đã nhận yêu cầu, đang tiếp tục xử lý

2xx: Thành công — yêu cầu đã được nhận và chấp nhận thành công

3xx: Chuyển hướng — cần thêm hành động để hoàn tất yêu cầu

4xx: Lỗi client — yêu cầu chứa cú pháp sai hoặc không thể thực hiện

5xx: Lỗi máy chủ — máy chủ không thể hoàn thành một yêu cầu hợp lệ

Cách Tính

Nhập một mã trạng thái (như 404) hoặc từ khóa (như "forbidden") vào ô tìm kiếm.
Lọc theo nhóm bằng các nút 1xx-5xx nếu bạn muốn duyệt một dải cụ thể.
Đọc mô tả dễ hiểu về ý nghĩa của mã và thời điểm nó thường được trả về.
Dùng công cụ này như một tài liệu tham khảo nhanh khi gỡ lỗi phản hồi API hoặc xây dựng xử lý lỗi.

Ví Dụ

Tìm kiếm "429" trả về "Too Many Requests" — mã mà các API trả về khi bạn đã vượt quá giới hạn tốc độ yêu cầu, báo bạn nên chậm lại và thử lại sau một khoảng trễ.

Lợi Ích Chính

Mọi mã trạng thái thường dùng trong một tài liệu tham khảo có thể tìm kiếm
Giải thích dễ hiểu, không chỉ là câu chữ RFC hình thức
Lọc ngay lập tức theo nhóm (từ 1xx đến 5xx)
Miễn phí, nhanh, không cần đăng ký

Những Lỗi Thường Gặp Cần Tránh

Trả về 200 OK cho một yêu cầu thực sự thất bại, che giấu lỗi khỏi các công cụ giám sát
Nhầm lẫn 401 (chưa xác thực) với 403 (đã xác thực nhưng không được ủy quyền)
Dùng 302 cho một chuyển hướng lẽ ra phải là vĩnh viễn (301), gây hại cho SEO
Xử lý mọi lỗi 4xx và 5xx giống nhau ở phía client thay vì phân nhánh theo mã cụ thể

Mẹo Chuyên Nghiệp

Chỉ dành riêng mã 5xx cho lỗi phía máy chủ — không bao giờ dùng chúng để báo hiệu lỗi đầu vào của client
Dùng 429 kèm tiêu đề Retry-After khi giới hạn tốc độ, để các client được thiết kế tốt biết khi nào nên thử lại
Ưu tiên dùng 404 thay vì trang lỗi chung khi một tài nguyên thực sự không tồn tại — điều này tốt hơn cho cả người dùng và công cụ tìm kiếm
Khi thiết kế API, chọn các mã 4xx cụ thể (422, 409, 400) thay vì mặc định mọi thứ về 400 chung chung

Các Thuật Ngữ Chính Được Giải Thích

Status line: dòng đầu tiên của phản hồi HTTP, chứa mã trạng thái và một cụm từ lý do ngắn gọn
Idempotent: một tính chất của một số phương thức HTTP mà việc lặp lại cùng một yêu cầu có tác dụng giống như thực hiện một lần
Chuỗi chuyển hướng (Redirect chain): một dãy nhiều lần chuyển hướng mà trình duyệt phải theo trước khi đến được tài nguyên cuối cùng
Giới hạn tốc độ (Rate limiting): hạn chế số lượng yêu cầu mà một client có thể thực hiện trong một khoảng thời gian nhất định, thường được báo hiệu bằng mã 429

Trường Hợp Sử Dụng Phổ Biến

Nhanh chóng hiểu một mã trạng thái xa lạ được trả về bởi API mà bạn đang tích hợp
Quyết định mã trạng thái nào nên trả về từ API của riêng bạn cho một điều kiện lỗi nhất định
Gỡ lỗi lý do một yêu cầu thất bại bằng cách kiểm tra ý nghĩa thực sự của một mã cụ thể
Giảng dạy hoặc học các kiến thức cơ bản về HTTP trong khóa học phát triển web
Viết logic xử lý lỗi chính xác phân biệt giữa các trường hợp 4xx và 5xx khác nhau

Câu Hỏi Thường Gặp

Các dải mã trạng thái HTTP khác nhau nghĩa là gì?

Mã 1xx là thông tin, 2xx nghĩa là thành công, 3xx cho biết chuyển hướng, 4xx nghĩa là phía client mắc lỗi (như yêu cầu một trang không tồn tại), và 5xx nghĩa là bản thân máy chủ không thể hoàn thành một yêu cầu hợp lệ.

Sự khác biệt giữa 401 và 403 là gì?

401 Unauthorized nghĩa là bạn chưa xác thực (hoặc thông tin đăng nhập không hợp lệ) — máy chủ không biết bạn là ai. 403 Forbidden nghĩa là máy chủ biết bạn là ai nhưng bạn không có quyền truy cập tài nguyên đó.

Tại sao đôi khi tôi thấy mã 200 cho một trang rõ ràng đã tải thất bại?

Điều này thường có nghĩa là máy chủ đã trả về một phản hồi HTTP hợp lệ (do đó là 200 OK) nhưng nội dung ở cấp ứng dụng của phản hồi đó lại mô tả một lỗi — một mô hình phổ biến trong các API đặt chi tiết lỗi trong phần thân phản hồi thay vì trong mã trạng thái.

Sự khác biệt giữa chuyển hướng 301 và 302 là gì?

301 Moved Permanently báo cho trình duyệt và công cụ tìm kiếm cập nhật bản ghi của họ và dùng URL mới từ nay về sau. 302 Found báo hiệu một chuyển hướng tạm thời — URL gốc vẫn nên được dùng cho các yêu cầu trong tương lai.