TanodTools
VI

Mã trạng thái HTTP

Tra cứu mọi mã trạng thái HTTP theo số hoặc theo từ khóa, với ý nghĩa dễ hiểu, nguyên nhân thường gặp, cách khắc phục và RFC định nghĩa nó.

Chạy hoàn toàn trong trình duyệt của bạn

Liệt kê các mã trong IANA HTTP Status Code Registry, trong đó 306 và 418 được hiển thị là các mã dành riêng, cùng một nhóm nhỏ mã không chính thức thường gặp từ nginx, Cloudflare và Laravel, có ghi rõ nguồn. Các mã riêng của nhà cung cấp khác không được đề cập.

Cách tra cứu mã trạng thái

  1. Nhập số, chẳng hạn 502, hoặc một từ, chẳng hạn rate limit hay redirect, vào ô tìm kiếm.
  2. Thu hẹp danh sách bằng các nút lớp: 1xx đến 5xx cho các mã tiêu chuẩn, hoặc Không chính thức cho các mã của nginx, Cloudflare và Laravel.
  3. Mở một mã để xem khi nào nó xuất hiện và cần làm gì, cả khi bạn là client lẫn chủ máy chủ. Dùng liên kết # để chia sẻ đường dẫn trực tiếp đến mã đó.

Đọc mã trạng thái HTTP

Mỗi phản hồi HTTP bắt đầu bằng một mã trạng thái ba chữ số cho client biết điều gì đã xảy ra với yêu cầu của nó. Chữ số đầu tiên cho biết họ mã: 1xx cho thông báo tiến trình, 2xx cho thành công, 3xx cho chuyển hướng, 4xx cho vấn đề ở yêu cầu và 5xx cho lỗi ở phía máy chủ. Một chương trình không biết một mã cụ thể vẫn có thể xử lý đúng bằng cách nhìn vào chữ số đầu đó, và vì vậy có thể thêm mã mới mà không làm hỏng các client cũ.

Danh sách chính thức được lưu trong IANA HTTP Status Code Registry, còn ý nghĩa được ghi trong RFC 9110 (HTTP Semantics) và một số RFC khác cho WebDAV và các phần mở rộng. Cụm từ lý do sau con số, chẳng hạn Not Found, chỉ là nhãn; HTTP/2 và HTTP/3 không mang theo nó. Một vài cụm từ đã được đổi tên năm 2022, nên 413 nay là Content Too Large và 422 là Unprocessable Content.

Các máy chủ ngoài tiêu chuẩn cũng tự đặt ra mã. nginx ghi log 499 khi client ngắt kết nối, còn Cloudflare dùng 520 đến 526 để mô tả sự cố giữa mạng của họ và máy chủ gốc của bạn. Chúng xuất hiện ở đây trong một nhóm riêng để không bị nhầm với các mã đã đăng ký. Khi gỡ lỗi, hãy nhớ rằng mã bạn thấy có thể đến từ proxy hoặc CDN phía trước ứng dụng, chứ không phải từ chính ứng dụng.

Mẹo

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

Năm nhóm mã trạng thái có ý nghĩa gì?

Chữ số đầu tiên xác định nhóm. 1xx là thông tin và yêu cầu vẫn đang được xử lý, 2xx là thành công, 3xx nghĩa là client phải thực hiện thêm một bước (thường là chuyển hướng), 4xx nghĩa là yêu cầu có vấn đề từ phía client, và 5xx nghĩa là máy chủ thất bại với một yêu cầu trông có vẻ hợp lệ.

401 và 403 khác nhau thế nào?

401 nghĩa là máy chủ không biết bạn là ai: thông tin xác thực bị thiếu, sai hoặc hết hạn, và đăng nhập có thể giải quyết được. 403 nghĩa là máy chủ biết bạn là ai và bạn không được phép làm việc này, nên gửi lại cùng thông tin xác thực sẽ không giúp ích.

Nên dùng 301 hay 302 để chuyển hướng?

Dùng 301 (hoặc 308) khi việc chuyển là vĩnh viễn, để trình duyệt và công cụ tìm kiếm chuyển sang địa chỉ mới. Dùng 302 (hoặc 307) khi địa chỉ cũ sẽ quay lại. 307 và 308 giữ nguyên phương thức yêu cầu, còn 301 và 302 cho phép các client cũ biến POST thành GET.

418 I'm a teapot có phải là mã trạng thái thật không?

Nó khởi đầu là trò đùa Cá tháng Tư trong RFC 2324 cho một giao thức điều khiển ấm pha cà phê. IANA hiện liệt kê 418 là không dùng, được dành riêng để nó không bị gán một ý nghĩa thật. Một số trang vẫn trả về mã này cho vui hoặc để từ chối công cụ cào dữ liệu, nhưng đây không phải là phản hồi tiêu chuẩn.

520 đến 526 và 499 là gì?

Chúng không nằm trong các tiêu chuẩn HTTP. 520 đến 526 là lỗi của Cloudflare báo cáo sự cố giữa Cloudflare và máy chủ của bạn, còn 499 là mã log của nginx cho client ngắt kết nối trước khi nhận phản hồi. Chúng được hiển thị trong nhóm Không chính thức cùng nguồn của chúng.

Vì sao lỗi 5xx đôi khi tự hết khi tôi thử lại?

Nhiều lỗi 5xx đến từ quá tải, backend đang khởi động lại hoặc sự cố mạng ngắn, và có thể tự hết trong vài giây. Thử lại với thời gian chờ tăng dần là an toàn với các yêu cầu idempotent như GET; với POST, hãy kiểm tra xem lần thử đầu tiên đã thành công chưa.