Mã trạng thái HTTP là gì?

Mã trạng thái HTTP là các số có 3 chữ số mà máy chủ trả về để thông báo cho máy khách biết yêu cầu thành công, được chuyển hướng hay thất bại. Chúng được nhóm thành năm lớp: 1xx thông tin, 2xx thành công, 3xx chuyển hướng, 4xx lỗi máy khách và 5xx lỗi máy chủ.

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

401 Unauthorized có nghĩa là yêu cầu không có xác thực hợp lệ — máy khách nên đăng nhập hoặc làm mới mã báo mật (token). 403 Forbidden có nghĩa là máy khách đã được xác thực nhưng không có quyền truy cập vào tài nguyên cụ thể này, và việc xác thực lại sẽ không giải quyết được vấn đề.

Khi nào tôi nên sử dụng 404 so với 410?

Trả về 404 Not Found khi không biết tài nguyên hoặc tài nguyên có thể tồn tại ở nơi khác. Trả về 410 Gone khi bạn đã chủ động xóa tài nguyên và muốn các trình thu thập thông tin cũng như máy khách ngừng yêu cầu — ví dụ: khi ngừng hoạt động một điểm cuối API.

Tại sao mã 418 I am a teapot lại có trong thông số kỹ thuật?

Nó bắt nguồn từ RFC 2324, một trò đùa ngày Cá tháng Tư về Giao thức Điều khiển Ấm pha Cà phê Siêu văn bản. Nó đã được cộng đồng lưu giữ và được đăng ký trong IANA, một phần để cho vui và một phần để ngăn số mã này bị sử dụng lại.

Sự khác biệt giữa 502, 503 và 504 là gì?

502 Bad Gateway có nghĩa là một máy chủ ủy quyền (proxy) đã nhận được phản hồi không đúng định dạng từ máy chủ gốc. 503 Service Unavailable có nghĩa là bản thân máy chủ đang bị quá tải hoặc đang bảo trì. 504 Gateway Timeout có nghĩa là máy chủ ủy quyền đã kết nối được với máy chủ gốc nhưng phản hồi không đến kịp thời.

Các mã trạng thái này có giống nhau trong HTTP/2 và HTTP/3 không?

Có. HTTP/2 và HTTP/3 chỉ thay đổi cách đóng khung và truyền tải. Ý nghĩa của các mã trạng thái không thay đổi và được định nghĩa trong RFC 9110, đây là tài liệu về ý nghĩa HTTP độc lập với phiên bản.

Tham Khảo Mã Trạng Thái HTTP

Duyệt, tìm kiếm và lọc mọi mã trạng thái HTTP từ 1xx Thông tin đến 5xx Lỗi Máy chủ. Mỗi mục bao gồm ý nghĩa chuẩn tắc, tài liệu tham khảo RFC, khi nào nên sử dụng, các lỗi thường gặp, và các mẫu mã nguồn có thể sao chép ngay cho Express, Django, FastAPI, và Go net/http.

⚡ Tra cứu nhanh

Nhập một mã (404) hoặc một phần của tên (teapot, gateway, redirect…)

Thử:

Quang phổ Trạng thái HTTP

62 mã đã đăng ký · nhấp vào một nhóm để lọc danh sách bên dưới

Đang hiển thị 62 / 62

Embed Tham Khảo Mã Trạng Thái HTTP Widget

Giới thiệu về Tham Khảo Mã Trạng Thái HTTP

Tài liệu Tham khảo Mã Trạng Thái HTTP là một danh mục hoàn chỉnh, có thể tìm kiếm của mọi mã trạng thái được định nghĩa trong các thông số kỹ thuật HTTP — từ 100 Continue cho đến 511 Network Authentication Required. Mỗi mục hiển thị tên chuẩn tắc, RFC định nghĩa mã đó, ý nghĩa thực sự của mã là gì, khi nào nên gửi, khi nào không nên gửi, và các lỗi thường gặp làm ảnh hưởng đến các cơ sở mã nguồn trong thực tế. Bộ lọc trực tiếp và các thẻ phân loại giúp bạn chuyển từ lớp này sang lớp khác chỉ với một cú nhấp chuột.

Không giống như một bảng tra cứu thông tin phẳng thông thường, công cụ này cung cấp cho mỗi mã một trang vi mô riêng với ba bảng màu được mã hóa (nên dùng / không nên dùng / lỗi thường gặp) cùng các trình xử lý có sẵn để sao chép cho Express.js, Django, FastAPI, và Go net/http. Sơ đồ đường truyền động hiển thị hành trình yêu cầu từ máy khách đến máy chủ và mã trạng thái được chọn truyền ngược lại — rất hữu ích cho những người mới bắt đầu tìm hiểu về những gì mã trạng thái thực sự đại diện trên đường truyền.

Tại sao một tài liệu tham khảo mã trạng thái lại quan trọng

🎯 Chọn đúng mã

Việc chọn mã 200 đi kèm một nội dung lỗi, hoặc mã 500 cho một lỗi xác thực dữ liệu, sẽ gửi các lỗi này đến hệ thống giám sát của bạn và làm máy khách bối rối. Các bảng nên dùng / không nên dùng sẽ giúp lựa chọn chuẩn tắc trở nên rõ ràng.

📚 Trích dẫn RFC

Mỗi mã đều liên kết đến phần tương ứng của RFC 9110, RFC 6585, RFC 4918, hoặc tài liệu định nghĩa khác. Không còn phải tranh cãi về việc liệu 422 là dành cho cú pháp hay ngữ nghĩa.

🧩 Đoạn mã framework

Các dòng mã ngắn gọn chính xác cho Express, Django, FastAPI, và Go net/http — bao gồm cả các tiêu đề (headers) mà máy khách nghiêm ngặt mong đợi (Location cho 201, Retry-After cho 429 và 503, Allow cho 405).

Cách sử dụng Tài liệu Tham khảo Mã Trạng Thái HTTP

Tra cứu nhanh. Nhập một số mã (404) hoặc một phần tên (teapot, gateway) vào hộp tìm kiếm ở trên cùng rồi gửi. Mục khớp từ khóa sẽ mở ra với bảng chi tiết đầy đủ.
Duyệt theo lớp mã. Nhấp vào bất kỳ thẻ nào trong 5 thẻ phân loại (1xx, 2xx, 3xx, 4xx, 5xx) để lọc lưới thẻ theo lớp đó. Nhấp vào Tất cả để đặt lại.
Bộ lọc trực tiếp. Hộp lọc ngay phía trên lưới thẻ sẽ thu hẹp các thẻ khi bạn nhập — hữu ích khi bạn chỉ nhớ một nửa tên như too many hoặc precondition.
Kiểm tra một mã. Nhấp vào bất kỳ thẻ nào để mở bảng chi tiết của mã đó. Bạn sẽ thấy ý nghĩa, khi nào nên dùng, khi nào không nên dùng, các lỗi thường gặp và một khối đoạn mã cho 4 framework.
Sao chép một đoạn mã. Sử dụng trình chuyển đổi tab và nút Sao chép nhỏ để lấy trình xử lý có sẵn để dán.
So sánh các mã lân cận. Bảng chi tiết kết thúc bằng các thẻ anh em cùng lớp mã (1xx / 2xx / 3xx / 4xx / 5xx) để so sánh song song một cách nhanh chóng.

Năm lớp trạng thái HTTP sơ lược

Lớp mã	Ý nghĩa	Mã tiêu biểu nổi tiếng
1xx Thông tin	Tạm thời, dữ liệu đang tiếp tục đến	100 Continue, 101 Switching Protocols, 103 Early Hints
2xx Thành công	Yêu cầu đã thành công	200 OK, 201 Created, 204 No Content, 206 Partial Content
3xx Chuyển hướng	Cần thực hiện hành động tiếp theo	301 Moved Permanently, 302 Found, 304 Not Modified, 308 Permanent Redirect
4xx Lỗi máy khách	Yêu cầu bị sai	400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found, 429 Too Many Requests
5xx Lỗi máy chủ	Máy chủ bị lỗi	500 Internal Server Error, 502 Bad Gateway, 503 Service Unavailable, 504 Gateway Timeout

Các cặp mã thường bị nhầm lẫn

401 so với 403. 401 có nghĩa là chưa xác thực — yêu cầu thiếu thông tin đăng nhập hợp lệ. 403 có nghĩa là đã xác thực nhưng không được phép — thông tin đăng nhập hoàn toàn ổn nhưng người dùng không có quyền truy cập.
404 so với 410. 404 có nghĩa là không xác định: có thể nó tồn tại ở đâu đó, hoặc có thể do lỗi chính tả. 410 có nghĩa là chủ động xóa bỏ: các công cụ tìm kiếm nên gỡ bỏ nó khỏi danh mục chỉ mục.
301 so với 302 so với 307 so với 308. 301 / 308 là vĩnh viễn (308 bảo lưu nghiêm ngặt phương thức & nội dung), 302 / 307 là tạm thời (307 bảo lưu nghiêm ngặt phương thức & nội dung). Hãy sử dụng 307 / 308 cho các chuyển hướng POST / PUT / PATCH.
400 so với 422. 400 có nghĩa là nội dung yêu cầu không đúng định dạng (sai JSON, thiếu trường dữ liệu). 422 có nghĩa là nội dung được phân tích cú pháp thành công nhưng các giá trị không vượt qua được các quy tắc nghiệp vụ (định dạng email không hợp lệ, số lượng vượt quá phạm vi).
502 so với 503 so với 504. 502 có nghĩa là máy chủ tuyến trên gửi dữ liệu rác. 503 có nghĩa là máy chủ đang bị quá tải hoặc đang bảo trì. 504 có nghĩa là máy chủ tuyến trên không phản hồi kịp thời.
409 so với 412. 409 là một sự xung đột với trạng thái hiện tại của tài nguyên. 412 có nghĩa cụ thể là một tiêu đề điều kiện tiên quyết (If-Match, If-Unmodified-Since) được đánh giá là sai.

Các tiêu đề đi kèm với các mã trạng thái cụ thể

201 Created — nên bao gồm tiêu đề Location trỏ tới tài nguyên mới.
301 / 302 / 307 / 308 — phải bao gồm tiêu đề Location chứa URL đích.
304 Not Modified — phải phản hồi lại các tiêu đề đáng lẽ sẽ xuất hiện trên mã 200 (ETag, Cache-Control, Vary).
401 Unauthorized — phải bao gồm tiêu đề WWW-Authenticate liệt kê các phương thức được chấp nhận (Basic, Bearer).
405 Method Not Allowed — phải bao gồm tiêu đề Allow liệt kê các phương thức được phép sử dụng.
413 / 429 / 503 — thường bao gồm Retry-After (số giây hoặc định dạng ngày HTTP) để máy khách lùi thời gian yêu cầu lại một cách chính xác.
416 Range Not Satisfiable — phải bao gồm tiêu đề Content-Range: bytes */<length>.

Các mã trạng thái bạn hầu như luôn có thể bỏ qua

Một vài mã trạng thái hợp lệ về mặt kỹ thuật nhưng cực kỳ hiếm gặp trong các API hiện đại: 305 Use Proxy (đã ngừng sử dụng), 306 (được đặt trước, không sử dụng), 305, 506 Variant Also Negotiates, 510 Not Extended, và 508 Loop Detected. Hầu hết được giữ lại trong danh mục đăng ký vì lý do lịch sử. Nếu thư viện hoặc phần mềm trung gian (middleware) của bạn phát ra một trong số các mã đó, hãy coi đó là một báo cáo lỗi đối với thư viện — chứ không phải là một gợi ý để xử lý nó một cách đặc biệt.

Câu hỏi thường gặp

Công cụ này có bao gồm các mã từ các RFC khác ngoài 9110 không?: Có. Nó bao gồm RFC 9110 (ngữ nghĩa HTTP), RFC 6585 (bổ sung 4xx / 5xx), RFC 4918 (WebDAV), RFC 5842 (WebDAV bindings), RFC 7725 (451), RFC 8297 (103 Early Hints), RFC 8470 (425 Too Early), và tài liệu mang tính chất vui nhộn nổi tiếng RFC 2324 (418 Teapot).
Các mã này có hợp lệ trong HTTP/2 và HTTP/3 không?: Có. Ý nghĩa của mã trạng thái được định nghĩa trong RFC 9110, đây là tài liệu về ý nghĩa HTTP độc lập với phiên bản. HTTP/2 (RFC 9113) và HTTP/3 (RFC 9114) chỉ thay đổi cách đóng khung và truyền tải.
Tôi có thể liên kết trực tiếp đến một mã cụ thể không?: Hãy gửi biểu mẫu với một mã duy nhất (ví dụ 404) và bảng chi tiết sẽ tải ở bên dưới biểu mẫu. URL hiển thị tìm kiếm của bạn và an toàn để chia sẻ — khi mở nó ra sẽ tải cùng một kết quả tương tự.
Tại sao framework của tôi không cho phép tôi trả về mã 418?: Các phiên bản cũ của một số thư viện HTTP từ chối phát ra các mã không nằm trong danh mục đăng ký nội bộ của chúng. Cách khắc phục là nâng cấp thư viện hoặc, nếu có thể, tự viết dòng trạng thái theo cách thủ công.
Một API có bao giờ nên trả về mã 200 với nội dung lỗi không?: Không. Các hệ thống giám sát, cơ chế thử lại và các bên trung gian đều giả định rằng 2xx có nghĩa là thành công. Nếu bạn phải trả về cấu trúc lỗi, hãy trả về một mã 4xx hoặc 5xx phù hợp và đặt chi tiết cấu trúc lỗi bên trong nội dung phản hồi. Định dạng Problem Details cho HTTP APIs (RFC 9457) là một khuôn mẫu tốt.
Có danh mục đăng ký chính thức nào cho các mã trạng thái HTTP không?: Có. IANA duy trì danh mục đăng ký tại iana.org/assignments/http-status-codes. Công cụ này luôn đồng bộ với danh mục đăng ký đó cùng với các RFC được trích dẫn phổ biến nhất.