Tài liệu tham khảo kỹ thuật

Mã trạng thái phản hồi HTTP

Mã trạng thái HTTP là các tín hiệu gồm ba chữ số trong phản hồi của máy chủ. Chữ số đầu tiên xác định kết quả chung; các chữ số còn lại xác định một điều kiện cụ thể. Hướng dẫn này giải thích các mã tiêu chuẩn đã đăng ký cùng với ngữ cảnh thực tế, cộng thêm các giá trị cụ thể của nhà cung cấp đáng chú ý có thể xuất hiện trong nhật ký.

Cách đọc danh mục này: Một trạng thái tự nó không phải là một chẩn đoán hoàn chỉnh. Hãy kiểm tra phương thức yêu cầu (request method), tiêu đề phản hồi (response headers), phần nội dung (body), đích chuyển hướng, và máy chủ hoặc proxy đã tạo ra nó. Các giá trị không được nhận dạng thường giữ lại ý nghĩa của lớp chữ số đầu tiên của chúng, nhưng hành vi chính xác của chúng có thể phụ thuộc vào việc triển khai (implementation-specific).

Khả năng tương thích của trình duyệt và xử lý phản hồi

Mã trạng thái HTTP là một phần của giao thức HTTP, không phải là tính năng của trình duyệt mà mỗi nhà cung cấp triển khai như một API web riêng biệt. Các trình duyệt hiện tại có thể xử lý các lớp phản hồi tiêu chuẩn; các trang lỗi hiển thị và hành vi thử lại là dành riêng cho từng trình duyệt. Hỗ trợ cho các phản hồi trung gian mới hơn và các tiện ích mở rộng chuyên biệt có thể khác nhau tùy theo phiên bản và đường dẫn mạng.

Họ phản hồiChrome / EdgeFirefoxSafariOperaAndroid / iOS WebViewLưu ý về khả năng tương thích
1xx thông tinĐược hỗ trợ như các phản hồi trung gian của giao thứcĐược hỗ trợ như các phản hồi trung gian của giao thứcĐược hỗ trợ như các phản hồi trung gian của giao thứcĐược hỗ trợ như các phản hồi trung gian của giao thứcĐược hỗ trợ bởi ngăn xếp mạng cơ bản100/101 đã được thiết lập; 102 là thích hợp/đã lỗi thời. Việc áp dụng 103 Early Hints và hành vi tải trước có thể quan sát được thay đổi tùy theo phiên bản trình duyệt, máy chủ và bên trung gian.
2xx thành côngĐược hỗ trợĐược hỗ trợĐược hỗ trợĐược hỗ trợĐược hỗ trợNgữ nghĩa thành công tiêu chuẩn được chia sẻ. Các quy tắc nội dung vẫn quan trọng: ví dụ, 204 và 205 không có nội dung phản hồi.
3xx chuyển hướngĐược hỗ trợĐược hỗ trợĐược hỗ trợĐược hỗ trợĐược hỗ trợVị trí, phương thức, bộ nhớ đệm và chính sách bảo mật ảnh hưởng đến điều hướng. 301/302 có thể thay đổi POST thành GET; 307/308 giữ nguyên phương thức.
4xx lỗi máy khách/yêu cầuĐược hỗ trợĐược hỗ trợĐược hỗ trợĐược hỗ trợĐược hỗ trợTrình duyệt nhận được phản hồi; việc nó hiển thị nội dung máy chủ hay chế độ xem lỗi do trình duyệt tạo ra khác nhau tùy theo trạng thái và sản phẩm.
5xx lỗi máy chủĐược hỗ trợĐược hỗ trợĐược hỗ trợĐược hỗ trợĐược hỗ trợMáy khách có thể xử lý lớp phản hồi, nhưng các trang do proxy tạo ra, hành vi thử lại và giao diện người dùng chẩn đoán không giống nhau ở mọi trình duyệt.
Mã không xác định trong một lớp đã biếtXử lý ở cấp độ lớpXử lý ở cấp độ lớpXử lý ở cấp độ lớpXử lý ở cấp độ lớpXử lý ở cấp độ lớpMáy khách HTTP có thể suy ra lớp chung từ chữ số đầu tiên; không phụ thuộc vào mã tùy chỉnh có ngữ nghĩa tiêu chuẩn hoặc giao diện người dùng giống hệt nhau.

Khả năng tương thích ở đây mô tả việc xử lý ở cấp độ giao thức, không phải là sự đảm bảo rằng mọi trình duyệt đều hiển thị cùng một trang lỗi. Các máy khách cũ, WebView được nhúng, proxy và cổng bắt buộc có thể áp dụng các hành vi bổ sung.

1xx — Phản hồi thông tin

100

Tiếp tục

Máy chủ đã chấp nhận các tiêu đề yêu cầu và đang đợi phần nội dung yêu cầu còn lại. Nó thường được sử dụng với Expect: 100-continue để máy khách có thể tránh việc tải lên một nội dung lớn khi yêu cầu sẽ bị từ chối.

Hướng dẫn vận hành: Phản hồi tạm thời; tiếp tục gửi phần nội dung (body) chỉ khi có một phần được mong đợi.

101

Đang chuyển đổi giao thức

Máy chủ đồng ý thay đổi giao thức cho kết nối này sau khi máy khách yêu cầu nâng cấp. Quá trình bắt tay WebSocket là một cách sử dụng quen thuộc.

Hướng dẫn vận hành: Chuyển đổi cấp độ kết nối; xác minh các tiêu đề Upgrade và Connection.

102

Đang xử lý

Máy chủ WebDAV báo cáo rằng một thao tác kéo dài đã bắt đầu nhưng chưa hoàn thành. Đây là một phản hồi cũ/đã lỗi thời và không nên nhầm lẫn với kết quả cuối cùng.

Hướng dẫn vận hành: Trạng thái WebDAV tạm thời; đợi phản hồi cuối cùng.

103

Gợi ý sớm

Máy chủ gửi các tiêu đề sơ bộ, thường là gợi ý Link, trong khi chuẩn bị phản hồi cuối cùng. Máy khách có thể bắt đầu tìm nạp các tài sản có khả năng quan trọng sớm.

Hướng dẫn vận hành: Tối ưu hóa tạm thời (Interim optimization); phản hồi cuối cùng phải theo sau.

2xx — Phản hồi thành công

200

OK

Yêu cầu thành công. Phần thể hiện phụ thuộc vào phương thức: GET trả về tài nguyên, HEAD trả về siêu dữ liệu không có nội dung, và hành động ghi có thể trả về phần thể hiện kết quả.

Hướng dẫn vận hành: Sử dụng cho yêu cầu đã hoàn thành với một biểu diễn phản hồi khi thích hợp.

201

Đã tạo

Yêu cầu đã hoàn thành và tạo ra một hoặc nhiều tài nguyên. Phản hồi nên xác định tài nguyên mới, thường là với Location, và có thể trả về phần thể hiện của nó.

Hướng dẫn vận hành: Thường gặp sau POST hoặc PUT; đảm bảo tài nguyên được tạo có thể được định vị.

202

Đã chấp nhận

Máy chủ đã chấp nhận yêu cầu xử lý, nhưng quá trình xử lý chưa kết thúc và vẫn có thể thất bại. HTTP không gửi phản hồi thứ hai cho cùng một trao đổi sau đó.

Hướng dẫn vận hành: Cung cấp URL thao tác/trạng thái hoặc cách khác để biết kết quả cuối cùng.

203

Thông tin không có thẩm quyền

Một proxy hoặc bên trung gian chuyển đổi đã trả về siêu dữ liệu hoặc nội dung khác với phản hồi gốc. Nó báo hiệu rằng phản hồi không phải là phần thể hiện có thẩm quyền trực tiếp.

Hướng dẫn vận hành: Chỉ sử dụng khi phép biến đổi trung gian có liên quan.

204

Không có nội dung

Yêu cầu thành công và không có nội dung phản hồi để gửi. Các tiêu đề vẫn có thể mang siêu dữ liệu hữu ích, chẳng hạn như các trình xác nhận đã cập nhật.

Hướng dẫn vận hành: Không bao gồm phần thân phản hồi.

205

Đặt lại nội dung

Yêu cầu thành công và máy khách được hướng dẫn đặt lại chế độ xem hoặc biểu mẫu đã gửi nó. Không có nội dung phản hồi nào được gửi.

Hướng dẫn vận hành: Hữu ích cho các tương tác nên xóa/đặt lại trạng thái đầu vào hiện tại.

206

Nội dung một phần

Máy chủ đã thực hiện yêu cầu phạm vi hợp lệ và chỉ trả về (các) phạm vi byte được yêu cầu. Content-Range mô tả những gì đã được phân phối.

Hướng dẫn vận hành: Đảm bảo các giá trị range và Content-Range khớp nhau; phổ biến cho các tệp phương tiện/tải xuống có thể tiếp tục (resumable).

207

Đa trạng thái

Phản hồi WebDAV báo cáo các kết quả riêng biệt cho nhiều tài nguyên hoặc thao tác phụ, thường trong một phần thân XML có cấu trúc.

Hướng dẫn vận hành: Giải thích kết quả của từng tài nguyên được nhúng; trạng thái bên ngoài tự nó chưa phải là kết quả đầy đủ.

208

Đã được báo cáo

Phản hồi đa trạng thái WebDAV bỏ qua các thành viên đã được liệt kê trước đó trong cùng một phản hồi để tránh lặp lại chúng.

Hướng dẫn vận hành: Đặc thù của WebDAV; giải thích cùng với phản hồi đa trạng thái (multistatus) xung quanh.

226

Đã sử dụng IM

Máy chủ đã thực hiện lệnh GET bằng cách sử dụng các thao tác trên thể hiện và trả về một phần thể hiện được dẫn xuất từ tài nguyên hiện tại theo cơ chế delta đã thương lượng.

Hướng dẫn vận hành: Mã hóa delta chuyên biệt (Specialized delta encoding); máy khách và máy chủ phải đồng ý về phép biến đổi.

3xx — Chuyển hướng và xác thực bộ nhớ đệm

300

Nhiều lựa chọn

Mục tiêu có nhiều phần thể hiện hoặc điểm đến và phản hồi cung cấp các lựa chọn. Máy khách hoặc người dùng có thể chọn biến thể ưa thích.

Hướng dẫn vận hành: Bao gồm các lựa chọn thay thế rõ ràng; đừng giả định mọi máy khách sẽ tự động chọn.

301

Đã chuyển vĩnh viễn

Tài nguyên có một URI mới lâu dài. Máy khách có thể cập nhật các liên kết và bộ nhớ đệm đã lưu trữ, vì vậy chỉ sử dụng khi việc di chuyển được dự định là lâu dài.

Hướng dẫn vận hành: Đối với di chuyển SEO, hãy chuyển hướng trực tiếp đến URL tương đương cuối cùng và cập nhật các liên kết nội bộ.

302

Đã tìm thấy

Tài nguyên tạm thời có sẵn tại một URI khác. Hành vi lịch sử cho phép thay đổi phương thức trong một số trường hợp, vì vậy đây không phải là lựa chọn an toàn nhất khi yêu cầu POST bắt buộc phải giữ nguyên POST.

Hướng dẫn vận hành: Sử dụng cho các trường hợp di chuyển tạm thời khi việc viết lại phương thức được chấp nhận; cân nhắc 307 khi không được chấp nhận.

303

Xem mục khác

Máy khách nên truy xuất tài nguyên được chỉ định bởi Location bằng lệnh GET (hoặc HEAD nếu thích hợp), thay vì lặp lại hành động ban đầu. Thường được sử dụng sau khi gửi biểu mẫu.

Hướng dẫn vận hành: Thực hiện mẫu Post/Redirect/Get và tránh gửi lại hành động.

304

Không được sửa đổi

Lệnh GET hoặc HEAD có điều kiện cho biết rằng bản sao được lưu trong bộ nhớ đệm vẫn còn hiện hành. Phản hồi không có phần thân và cho phép máy khách tái sử dụng bản sao đã lưu trữ của mình.

Hướng dẫn vận hành: Chỉ trả về khi một trình xác thực như If-None-Match hoặc If-Modified-Since khớp.

305

Sử dụng Proxy

Một phản hồi trong lịch sử đề xuất rằng máy khách truy cập tài nguyên thông qua proxy. Tính năng này đã bị lỗi thời vì lý do bảo mật và không nên được sử dụng bởi các dịch vụ hiện đại.

Hướng dẫn vận hành: Không triển khai; cấu hình proxy ngoại tuyến (out of band).

306

Không sử dụng

Giá trị này được dự trữ/không sử dụng trong các thông số kỹ thuật HTTP hiện đại. Nó không có ý nghĩa vận hành tiêu chuẩn cho một ứng dụng web hiện tại.

Hướng dẫn vận hành: Không gửi mục này.

307

Chuyển hướng tạm thời

Tài nguyên tạm thời ở một URI khác và máy khách phải giữ nguyên phương thức cũng như phần thân ban đầu khi thực hiện chuyển hướng.

Hướng dẫn vận hành: Sử dụng khi việc định vị lại tạm thời không được làm biến đổi POST thành GET.

308

Chuyển hướng vĩnh viễn

Tài nguyên đã di chuyển vĩnh viễn và máy khách phải bảo tồn phương thức cũng như phần thân ban đầu khi tuân theo chuyển hướng.

Hướng dẫn vận hành: Sử dụng cho các trường hợp di chuyển lâu dài trong đó việc bảo tồn phương thức là quan trọng; cập nhật các tham chiếu chuẩn/nội bộ.

4xx — Lỗi máy khách/yêu cầu

400

Yêu cầu không hợp lệ

Máy chủ không thể xử lý yêu cầu vì cú pháp, khung dữ liệu hoặc dữ liệu được cung cấp không hợp lệ. Việc lặp lại yêu cầu y nguyên có khả năng sẽ không giúp ích gì.

Hướng dẫn vận hành: Kiểm tra mã hóa URL, cú pháp JSON/body, các trường bắt buộc, và cấu trúc khung yêu cầu (request framing).

401

Chưa được ủy quyền

Yêu cầu thiếu thông tin xác thực hợp lệ cho mục tiêu. Trái với tên gọi, phản hồi này có nghĩa là bắt buộc phải xác thực hoặc việc xác thực đã thất bại.

Hướng dẫn vận hành: Gửi thông tin xác thực dự kiến và bao gồm một thách thức WWW-Authenticate.

402

Yêu cầu thanh toán

Được dành riêng cho sử dụng trong tương lai, mặc dù một số sản phẩm sử dụng nó cho quy trình thanh toán hoặc hạn ngạch. Không có hành vi thanh toán nào tương thích phổ biến ở mọi nơi.

Hướng dẫn vận hành: Coi các ý nghĩa dành riêng cho nhà cung cấp đúng với bản chất của chúng; tài liệu hóa hợp đồng API.

403

Bị cấm

Máy chủ đã hiểu yêu cầu nhưng từ chối thực hiện. Thông tin xác thực hợp lệ không nhất thiết thay đổi kết quả vì hạn chế có thể dựa trên chính sách.

Hướng dẫn vận hành: Kiểm tra quyền, chính sách truy cập, quy tắc IP/WAF, và ủy quyền cấp tài nguyên (resource-level authorization).

404

Không tìm thấy

Máy chủ không thể tìm thấy bản thể hiện hiện tại cho URI được yêu cầu, hoặc không muốn tiết lộ rằng nó tồn tại. Bản thân phản hồi không cho biết việc vắng mặt là tạm thời hay vĩnh viễn.

Hướng dẫn vận hành: Sửa URL, khôi phục tài nguyên, hoặc sử dụng 410 khi việc xóa được biết chắc chắn là vĩnh viễn.

405

Phương thức không được phép

Tài nguyên tồn tại, nhưng nó không hỗ trợ phương thức được sử dụng trong yêu cầu này.

Hướng dẫn vận hành: Trả về tiêu đề Allow liệt kê các phương thức mà tài nguyên chấp nhận.

406

Không thể chấp nhận

Máy chủ không thể tạo ra bản thể hiện khớp với các tùy chọn Accept chủ động của máy khách.

Hướng dẫn vận hành: Nới lỏng các giới hạn Accept hoặc cấu hình chính sách thương lượng và biểu diễn phù hợp.

407

Yêu cầu xác thực proxy

Một proxy trung gian yêu cầu thông tin xác thực trước khi nó chuyển tiếp yêu cầu.

Hướng dẫn vận hành: Xác thực với proxy bằng Proxy-Authenticate / Proxy-Authorization; điều này khác biệt với xác thực nguồn (origin authentication).

408

Hết thời gian chờ yêu cầu

Máy chủ đã không nhận được yêu cầu hoàn chỉnh trong khoảng thời gian nó sẵn sàng chờ đợi. Máy khách có thể thử lại trên một kết nối mới.

Hướng dẫn vận hành: Kiểm tra tình trạng nghẽn mạng, kích thước tải lên, và cài đặt thời gian chờ của máy chủ/proxy.

409

Xung đột

Yêu cầu xung đột với trạng thái hiện tại của tài nguyên, chẳng hạn như xung đột phiên bản hoặc nỗ lực tạo ra bản sao trùng lặp.

Hướng dẫn vận hành: Giải thích xung đột và cung cấp đủ trạng thái hiện tại để máy khách giải quyết nó.

410

Đã mất (Gone)

Tài nguyên có chủ đích và có khả năng vĩnh viễn không có sẵn, không có bản thay thế nào được biết đến. Điều này mạnh mẽ hơn phản hồi không tìm thấy (not-found) thông thường.

Hướng dẫn vận hành: Sử dụng khi việc xóa là có chủ ý; xóa các liên kết và tham chiếu nội bộ lỗi thời.

411

Yêu cầu độ dài

Máy chủ yêu cầu tiêu đề Content-Length nhưng yêu cầu lại không cung cấp.

Hướng dẫn vận hành: Gửi Content-Length chính xác hoặc sử dụng khung truyền tải được hỗ trợ.

412

Tiền điều kiện không thành công

Một điều kiện yêu cầu như If-Match được đánh giá là sai, vì vậy máy chủ không thực hiện hành động được yêu cầu.

Hướng dẫn vận hành: Làm mới phần biểu diễn (representation) và thử lại với các trình xác thực/trạng thái hiện tại.

413

Nội dung quá lớn

Phần thân yêu cầu vượt quá giới hạn mà máy chủ sẵn sàng hoặc có khả năng xử lý. Máy chủ có thể đóng kết nối hoặc cho phép thử lại sau khi làm giảm kích thước phần thân.

Hướng dẫn vận hành: Giảm kích thước payload hoặc điều chỉnh giới hạn tải lên đã được tài liệu hóa.

414

URI quá dài

Mục tiêu yêu cầu dài hơn mức mà máy chủ sẵn sàng diễn giải, thường là do chuỗi truy vấn (query string) quá lớn.

Hướng dẫn vận hành: Sử dụng URI ngắn hơn hoặc di chuyển dữ liệu phù hợp vào phần thân yêu cầu (request body).

415

Loại phương tiện không được hỗ trợ

Máy chủ từ chối phần thân yêu cầu vì loại phương tiện, mã hóa nội dung hoặc định dạng được kiểm tra không được hỗ trợ.

Hướng dẫn vận hành: Gửi một Content-Type/encoding được hỗ trợ và phần thân khớp với nó.

416

Phạm vi không thỏa mãn

Phạm vi byte được yêu cầu không thể phục vụ, ví dụ vì nó bắt đầu vượt quá độ dài bản thể hiện.

Hướng dẫn vận hành: Kiểm tra lại độ dài tài nguyên và các đơn vị phạm vi (range units); máy chủ có thể trả về Content-Range: bytes */length.

417

Kỳ vọng không thành công

Máy chủ hoặc bên trung gian không thể đáp ứng kỳ vọng được khai báo trong tiêu đề Expect.

Hướng dẫn vận hành: Thử lại mà không có kỳ vọng không được hỗ trợ khi an toàn và thích hợp.

418

Tôi là một chiếc ấm trà

Một trạng thái hài hước bắt nguồn từ thông số kỹ thuật ngày Cá Tháng Tư. Đây không phải là hợp đồng lỗi ứng dụng thông thường, mặc dù một số dịch vụ sử dụng nó một cách vui đùa.

Hướng dẫn vận hành: Không phụ thuộc vào nó để có hành vi sản xuất tương thích lẫn nhau (interoperable).

421

Yêu cầu sai hướng

Yêu cầu đã đến một máy chủ không thể tạo ra phản hồi có thẩm quyền cho URI mục tiêu, thường là do định tuyến kết nối hoặc quyền hạn HTTP không khớp.

Hướng dẫn vận hành: Thử lại qua kết nối phù hợp và kiểm tra Host/:authority, SNI, và định tuyến proxy.

422

Nội dung không thể xử lý

Loại nội dung và cú pháp được hiểu rõ, nhưng máy chủ không thể áp dụng các hướng dẫn hoặc xác thực nội dung đã gửi.

Hướng dẫn vận hành: Trả về chi tiết xác thực cấp trường có thể hành động được (actionable); việc sửa đổi payload có thể cho phép thành công.

423

Đã khóa

Tài nguyên WebDAV bị khóa, do đó phương thức được yêu cầu không thể thực hiện cho đến khi điều kiện khóa được giải quyết.

Hướng dẫn vận hành: Kiểm tra quyền sở hữu khóa, thời gian chờ (timeout), và xử lý mã thông báo khóa WebDAV (WebDAV lock-token handling).

424

Phụ thuộc thất bại

Một thao tác WebDAV thất bại do một thao tác trước đó bắt buộc trong cùng chuỗi yêu cầu đã thất bại.

Hướng dẫn vận hành: Giải quyết hành động thất bại trước đó trước khi thử lại các thao tác phụ thuộc.

425

Quá sớm

Máy chủ từ chối xử lý một yêu cầu có thể đã bị phát lại trong dữ liệu sớm (early data), nhằm giảm thiểu rủi ro phát lại.

Hướng dẫn vận hành: Thử lại sau khi kết nối được thiết lập mà không có dữ liệu sớm (early data).

426

Yêu cầu nâng cấp

Máy chủ từ chối giao thức hiện tại và chỉ ra rằng máy khách nên chuyển sang giao thức khác.

Hướng dẫn vận hành: Bao gồm tiêu đề Upgrade mô tả các lựa chọn giao thức được hỗ trợ.

428

Yêu cầu tiền điều kiện

Máy chủ yêu cầu một yêu cầu có điều kiện để ngăn ngừa mất dữ liệu cập nhật, nhưng máy khách lại gửi một yêu cầu không điều kiện.

Hướng dẫn vận hành: Lấy trạng thái hiện tại và gửi một điều kiện phù hợp như If-Match.

429

Quá nhiều yêu cầu

Máy khách đã gửi quá nhiều yêu cầu trong một khoảng thời gian xác định, dựa trên giới hạn tốc độ (rate limit) do máy chủ định nghĩa.

Hướng dẫn vận hành: Lùi lại (Back off), tuân thủ Retry-After khi có mặt, và tránh các đợt thử lại đồng bộ (synchronized retry bursts).

431

Các trường tiêu đề yêu cầu quá lớn

Máy chủ sẽ không xử lý yêu cầu vì một hoặc nhiều trường tiêu đề, hoặc tập hợp tiêu đề kết hợp, quá lớn.

Hướng dẫn vận hành: Giảm cookie hoặc header tùy chỉnh, hoặc điều chỉnh giới hạn máy chủ đã đặt có chủ đích.

451

Không có sẵn vì lý do pháp lý

Máy chủ không thể cung cấp tài nguyên được yêu cầu do hạn chế pháp lý.

Hướng dẫn vận hành: Khi thích hợp, hãy giải thích hạn chế và phạm vi của nó mà không làm lộ thông tin được bảo vệ.

5xx — Lỗi máy chủ và bên trung gian

500

Lỗi máy chủ nội bộ

Máy chủ gặp phải một điều kiện bất ngờ và không thể hoàn thành yêu cầu. Đây là phương án dự phòng chung khi không có lỗi máy chủ nào chính xác hơn được áp dụng.

Hướng dẫn vận hành: Liên kết yêu cầu với nhật ký máy chủ và tránh để lộ vết ngăn xếp (stack traces) cho khách truy cập.

501

Không được triển khai

Máy chủ không hỗ trợ tính năng được yêu cầu để thực hiện yêu cầu, thường là một phương thức hoặc khả năng chưa được triển khai.

Hướng dẫn vận hành: Triển khai tính năng hoặc sử dụng một phương thức được hỗ trợ; nó không dành cho tình trạng quá tải tạm thời.

502

Gateway tồi (Bad Gateway)

Một máy chủ đóng vai trò là cổng (gateway) hoặc proxy đã nhận được phản hồi không hợp lệ từ máy chủ thượng nguồn (upstream).

Hướng dẫn vận hành: Kiểm tra tình trạng sức khỏe thượng nguồn (upstream health), cài đặt giao thức/TLS, DNS, và nhật ký proxy.

503

Dịch vụ không có sẵn

Máy chủ tạm thời không thể xử lý yêu cầu, thường là do bảo trì hoặc quá tải.

Hướng dẫn vận hành: Nếu có thể, hãy cung cấp Retry-After, một phản hồi hữu ích, và các điều khiển bộ nhớ đệm phù hợp cho một lỗi tạm thời.

504

Hết thời gian chờ Gateway

Một cổng (gateway) hoặc proxy không nhận được phản hồi kịp thời từ dịch vụ thượng nguồn.

Hướng dẫn vận hành: Điều tra độ trễ thượng nguồn (upstream latency), đường dẫn mạng, và ngân sách thời gian chờ trong toàn bộ chuỗi.

505

Phiên bản HTTP không được hỗ trợ

Máy chủ không hỗ trợ phiên bản HTTP chính được sử dụng trong yêu cầu.

Hướng dẫn vận hành: Sử dụng phiên bản giao thức được hỗ trợ hoặc cập nhật cấu hình máy chủ/proxy.

506

Biến thể cũng thực hiện đàm phán

Lỗi cấu hình máy chủ đã tạo ra một sắp xếp đàm phán nội dung vòng tròn trong đó biến thể được chọn tiếp tục đàm phán lại.

Hướng dẫn vận hành: Sửa cấu hình biến thể/đàm phán (variant/negotiation); đây là lỗi phía nguồn (origin-side fault).

507

Không đủ dung lượng lưu trữ

Máy chủ WebDAV không thể lưu trữ bản thể hiện cần thiết để hoàn tất thao tác.

Hướng dẫn vận hành: Giải phóng hoặc cấp phát bộ nhớ và kiểm tra hạn ngạch trước khi thử lại.

508

Phát hiện vòng lặp

Máy chủ phát hiện thấy một vòng lặp vô hạn khi đang xử lý yêu cầu, thường xảy ra trong quá trình duyệt liên kết WebDAV.

Hướng dẫn vận hành: Phá vỡ mối quan hệ tài nguyên tuần hoàn hoặc quy tắc xử lý.

510

Không được mở rộng

Yêu cầu cần có một tiện ích mở rộng mà máy chủ không hỗ trợ.

Hướng dẫn vận hành: Sử dụng tập hợp tiện ích mở rộng được hỗ trợ hoặc đàm phán một giải pháp thay thế.

511

Yêu cầu xác thực mạng

Máy khách phải xác thực để có quyền truy cập vào mạng, thường là tại một cổng bắt buộc (captive portal). Nó dành cho các bên trung gian mạng, không phải là đăng nhập trang web gốc.

Hướng dẫn vận hành: Hoàn tất xác thực truy cập mạng, sau đó thử lại yêu cầu ban đầu.

Các phản hồi phi tiêu chuẩn và cụ thể của nhà cung cấp đáng chú ý

Các giá trị này được nhìn thấy ở các sản phẩm cụ thể, nhật ký máy chủ, cdn hoặc ứng dụng. chúng không thể hoán đổi cho nhau với các ý nghĩa tiêu chuẩn đã đăng ký; tham khảo hợp đồng của dịch vụ tạo ra.

419

Hết thời gian xác thực (phi tiêu chuẩn)

Một số ứng dụng sử dụng nhãn này khi phiên xác thực hết hạn. Đây không phải là mã trạng thái HTTP được gán phổ biến toàn cầu, vì vậy máy khách không thể dựa vào ngữ nghĩa nhất quán.

Hướng dẫn vận hành: Làm mới xác thực theo hợp đồng dịch vụ (service contract).

420

Nâng cao sự bình tĩnh của bạn (phi tiêu chuẩn)

Một phản hồi đặc thù của nhà cung cấp từng được sử dụng trong lịch sử để điều tiết (throttling). Ý nghĩa của nó phụ thuộc vào cách thực thi.

Hướng dẫn vận hành: Thực hiện hướng dẫn giới hạn tần suất đã được tài liệu hóa.

444

Kết nối đã đóng (phi tiêu chuẩn)

Một số máy chủ đóng kết nối mà không gửi phản hồi thông thường, thường như một biện pháp lọc.

Hướng dẫn vận hành: Kiểm tra nhật ký của nhà cung cấp; máy khách có thể báo cáo lỗi mạng thay vì hiển thị mã này.

449

Thử lại với (phi tiêu chuẩn)

Một tiện ích mở rộng của Microsoft được một số dịch vụ sử dụng để yêu cầu máy khách thử lại kèm theo thông tin bổ sung.

Hướng dẫn vận hành: Làm theo tài liệu cụ thể của API tương ứng.

499

Yêu cầu bị đóng bởi máy khách (phi tiêu chuẩn)

Một reverse proxy có thể ghi lại điều này khi máy khách ngắt kết nối trước khi phản hồi thượng nguồn hoàn tất. Đây thường là phân loại trong nhật ký hơn là phản hồi được gửi đến máy khách đó.

Hướng dẫn vận hành: Điều tra việc máy khách hủy yêu cầu (cancellations) và các yêu cầu thượng nguồn chậm.

509

Vượt quá giới hạn băng thông (phi tiêu chuẩn)

Một số nền tảng lưu trữ sử dụng mã này cho hạn ngạch hoặc giới hạn băng thông. Đây không phải là ý nghĩa HTTP tương thích chung.

Hướng dẫn vận hành: Kiểm tra hạn ngạch và cấu hình thanh toán của máy chủ lưu trữ (host).

520

Máy chủ web trả về lỗi không xác định (cụ thể của nhà cung cấp)

Một CDN hoặc proxy có thể sử dụng mã này khi nó nhận được phản hồi nguồn gốc (origin) bất ngờ hoặc trống.

Hướng dẫn vận hành: So sánh nhật ký của edge và origin; xác minh rằng origin phát hành một phản hồi HTTP hợp lệ.

521

Máy chủ web đã ngừng hoạt động (cụ thể của nhà cung cấp)

Một proxy không thể thiết lập kết nối tới nguồn gốc hoặc nguồn gốc đã từ chối kết nối đó.

Hướng dẫn vận hành: Kiểm tra tính khả dụng của nguồn (origin), quy tắc tường lửa, và danh sách cho phép của proxy (proxy allowlists).

522

Kết nối quá thời gian (cụ thể của nhà cung cấp)

Một dịch vụ biên (edge service) đã kết nối hoặc cố gắng kết nối tới nguồn gốc nhưng không hoàn tất quá trình trao đổi trong thời gian chờ (timeout) của nó.

Hướng dẫn vận hành: Xem xét khả năng phản hồi của nguồn (origin responsiveness) và độ trễ mạng.

523

Không thể tiếp cận nguồn gốc (cụ thể của nhà cung cấp)

Một proxy không thể tiếp cận địa chỉ nguồn gốc đã được cấu hình.

Hướng dẫn vận hành: Kiểm tra độ phân giải DNS, định tuyến, và cấu hình IP nguồn (origin IP).

524

Đã xảy ra lỗi quá thời gian (cụ thể của nhà cung cấp)

Kết nối tới nguồn gốc đã thành công, nhưng nguồn gốc không gửi phản hồi HTTP kịp thời.

Hướng dẫn vận hành: Giảm thời gian xử lý của máy chủ gốc hoặc điều chỉnh cài đặt timeout được hỗ trợ.

525

Bắt tay SSL thất bại (cụ thể của nhà cung cấp)

Một proxy không thể hoàn tất quá trình đàm phán TLS với nguồn gốc.

Hướng dẫn vận hành: Xác thực chứng chỉ, khả năng tương thích giao thức/mật mã (cipher), và SNI.

526

Chứng chỉ SSL không hợp lệ (cụ thể của nhà cung cấp)

Một bên trung gian đã từ chối chứng chỉ của nguồn gốc trong quá trình xác thực.

Hướng dẫn vận hành: Cài đặt một chứng chỉ hợp lệ, được đặt tên chính xác, đáng tin cậy, chưa hết hạn và có chuỗi đầy đủ.

527

Lỗi Railgun (cụ thể của nhà cung cấp)

Trạng thái proxy cũ/đặc thù của nhà cung cấp báo cáo lỗi trong kết nối tăng tốc nguồn gốc.

Hướng dẫn vận hành: Kiểm tra trình kết nối cụ thể của nhà cung cấp và đường dẫn nguồn (origin path).

598

Hết thời gian đọc mạng (phi tiêu chuẩn)

Một số máy khách hoặc proxy sử dụng giá trị này để mô tả thời gian chờ đọc mạng. Nó không có ý nghĩa HTTP toàn cục.

Hướng dẫn vận hành: Kiểm tra thông tin chẩn đoán của client hoặc proxy.

599

Hết thời gian kết nối mạng (phi tiêu chuẩn)

Một số proxy sử dụng giá trị này khi nỗ lực kết nối mạng bị quá thời gian. Ý nghĩa của nó phụ thuộc vào cách thực thi.

Hướng dẫn vận hành: Kiểm tra khả năng kết nối và cài đặt timeout.

Sử dụng mã trạng thái trong chuyển hướng và kiểm tra SEO

Đối với việc di chuyển url vĩnh viễn, hãy sử dụng chuyển hướng vĩnh viễn chỉ khi điểm đến được dự định thay thế url cũ; đối với thay đổi tạm thời, chọn phản hồi tạm thời. giữ cho chuỗi ngắn và trỏ đến điểm đến tương đương cuối cùng. xác nhận rằng mỗi giá trị vị trí giải quyết, phản hồi cuối cùng là thích hợp và các thẻ canonical và liên kết nội bộ đồng ý với url dự định. một 2xx ở cuối xác nhận phản hồi thành công http, không có nghĩa là trang hữu ích, có thể lập chỉ mục hoặc lành mạnh về mặt kỹ thuật.

Nguồn và ghi chú tham khảo

Trang này tóm tắt ý nghĩa thực tiễn của mã trạng thái HTTP. Sổ đăng ký tiêu chuẩn và RFC là nguồn có thẩm quyền đối với các mã được chuẩn hóa; MDN cung cấp hướng dẫn kỹ thuật dễ tiếp cận, còn Wikipedia là phần tổng quan bổ sung do cộng đồng duy trì.