Mã 307 và 308 là hai mã chuyển hướng bắt buộc chương trình gọi gửi lại yêu cầu với đúng phương thức và đúng dữ liệu như ban đầu. 307 Temporary Redirect là bản tạm thời, tương ứng ý nghĩa của 302. 308 Permanent Redirect là bản vĩnh viễn, tương ứng ý nghĩa của 301. Khác biệt duy nhất so với hai mã cũ là lời hứa không đổi POST thành GET.
Với trang web chỉ có liên kết và trang đọc, bạn hiếm khi thấy khác biệt. Nhưng khi chuyển hướng chạm vào biểu mẫu, điểm nhận tệp tải lên hay API mà ứng dụng di động, máy chủ đối tác gọi tới, chọn nhầm giữa 301 và 308 có thể làm mất dữ liệu một cách lặng lẽ. Bài này giải thích vì sao hai mã này tồn tại, khi nào nên dùng, và một hiện tượng hay gây bối rối trong công cụ nhà phát triển: dòng "307 Internal Redirect".
Vấn đề lịch sử mà 307 và 308 sinh ra để giải quyết
Khi HTTP/1.0 được viết, người soạn đặc tả muốn rằng chương trình gọi gặp 301 hoặc 302 sau một yêu cầu POST thì gửi lại POST tới địa chỉ mới, và nên hỏi người dùng trước khi gửi. Các trình duyệt thời đó chọn cách đơn giản hơn: đổi sang GET, bỏ thân yêu cầu, đi tiếp không hỏi ai. Hành vi này lan rộng tới mức trở thành chuẩn thực tế, và hàng loạt website bắt đầu dựa vào nó để đưa người dùng sang trang kết quả sau khi gửi biểu mẫu.
Đặc tả HTTP/1.1 không thể bắt mọi trình duyệt quay lại hành vi cũ mà không làm hỏng các website đang dựa vào nó. Giải pháp là tách ý định ra nhiều mã. 303 See Other dành cho trường hợp cố ý chuyển sang GET. 307 Temporary Redirect dành cho trường hợp tạm thời mà phải giữ phương thức. Còn 301 và 302 được để lại với hành vi lỏng: chương trình gọi được phép đổi POST thành GET.
Thiếu một mảnh: chuyển hướng vĩnh viễn mà giữ phương thức. Mảnh đó được bổ sung muộn hơn nhiều, trong RFC 7538 năm 2015, với mã 308 Permanent Redirect. Đến nay, cả bốn mã đều nằm trong đặc tả ngữ nghĩa HTTP hiện hành RFC 9110. Nhìn lại, bộ bốn có cấu trúc rất gọn: hai trục là tạm thời hay vĩnh viễn, và được đổi phương thức hay phải giữ nguyên.
Bốn mã chuyển hướng chính theo hai trục
Bảng dưới đặt 301, 302, 307, 308 cạnh nhau. 303 không có trong bảng vì nó luôn chuyển sang GET, được bàn ở bài riêng.
| Mã | Thời hạn | Đổi POST sang GET | Lưu bộ nhớ đệm mặc định | Máy tìm kiếm hiểu |
|---|---|---|---|---|
| 301 Moved Permanently | Vĩnh viễn | Được phép | Có | Tín hiệu mạnh đổi URL chuẩn |
| 302 Found | Tạm thời | Được phép | Không | Giữ URL gốc |
| 307 Temporary Redirect | Tạm thời | Không được | Không | Giữ URL gốc, như 302 |
| 308 Permanent Redirect | Vĩnh viễn | Không được | Có | Như 301 |
Google cho biết họ xử lý 308 giống 301 và 307 giống 302 về mặt lập chỉ mục. Vì thế, với trang web thông thường, đổi từ 301 sang 308 không mang lại lợi ích SEO nào; lợi ích chỉ nằm ở hành vi với các yêu cầu không phải GET.
Cột lưu bộ nhớ đệm cũng đáng chú ý: 308 được lưu mặc định giống 301, nên mọi lời cảnh báo về chuyện trình duyệt nhớ 301 rất lâu cũng áp dụng nguyên vẹn cho 308.
Khi nào nên dùng 307 và 308
Điểm cuối API đổi địa chỉ. Ví dụ giả định: API chuyển từ /v1/don-hang sang /api/v1/don-hang. Ứng dụng di động đời cũ vẫn gọi địa chỉ cũ bằng POST. Trả 308 giúp các ứng dụng đó tiếp tục đặt hàng được trong lúc người dùng chưa cập nhật, thay vì nhận GET rỗng và báo lỗi.
Ép HTTPS cho cả những yêu cầu ghi dữ liệu. Nếu quy tắc chuyển http sang https áp cho mọi đường dẫn, kể cả điểm nhận biểu mẫu và webhook, 308 an toàn hơn 301. Tuy vậy, điều tốt nhất vẫn là mọi chương trình gọi thẳng https ngay từ đầu, vì gửi dữ liệu qua http rồi mới được chuyển nghĩa là dữ liệu đã đi trên đường truyền không mã hoá.
Tạm chuyển máy chủ xử lý. Trong thời gian bảo trì một cụm máy, bạn tạm đưa các yêu cầu tải tệp lên sang cụm dự phòng ở địa chỉ khác. 307 giữ nguyên tệp trong thân yêu cầu, và vì là tạm thời, khi cụm chính quay lại chỉ cần gỡ quy tắc.
Giữ PUT, PATCH, DELETE. Với API kiểu REST dùng nhiều phương thức, hành vi đổi phương thức của 301 và 302 lại càng khó lường giữa các thư viện. 307 và 308 cho kết quả nhất quán hơn.
Dòng "307 Internal Redirect" trong trình duyệt không phải do máy chủ trả
Mở tab mạng trong công cụ nhà phát triển của các trình duyệt nhân Chromium, gõ một địa chỉ bằng http, bạn có thể thấy dòng đầu tiên ghi trạng thái 307 kèm chú thích "Internal Redirect" hoặc tương tự. Nhiều người tưởng máy chủ đang trả 307 và đi sửa cấu hình. Thực ra yêu cầu đó chưa hề rời khỏi máy bạn.
Lý do là HSTS. Khi một tên miền đã gửi tiêu đề Strict-Transport-Security ở lần ghé trước, hoặc nằm trong danh sách nạp sẵn của trình duyệt, trình duyệt cam kết chỉ dùng https với tên miền đó. Gặp địa chỉ http, nó tự đổi sang https ngay trong máy và hiển thị bước đổi ấy dưới dạng một chuyển hướng 307 nội bộ, để người xem công cụ nhà phát triển hiểu chuyện gì đã xảy ra. Chọn 307 là vì nó giữ nguyên phương thức và dữ liệu.
Cách phân biệt rất đơn giản: dùng dòng lệnh, ví dụ curl -I với địa chỉ http của tên miền. Curl không áp HSTS theo mặc định, nên bạn thấy đúng thứ máy chủ trả, thường là 301 hoặc 308. Nếu curl thấy 301 mà trình duyệt ghi 307 Internal Redirect, cấu hình máy chủ không có vấn đề gì. Nội dung chi tiết về HSTS và chuyển hướng nằm ở danh mục chuẩn hoá HTTPS và www.
Thư viện và công cụ đi theo 307, 308 thế nào
Không phải chương trình gọi nào cũng tự đi theo chuyển hướng. Trình duyệt luôn đi theo với yêu cầu điều hướng thông thường. Các thư viện gọi HTTP trong ngôn ngữ lập trình thì mỗi nơi một kiểu: có thư viện mặc định đi theo, có thư viện mặc định không, có thư viện đi theo với GET nhưng dừng lại với POST để người viết mã tự quyết. Trước khi dựa vào 308 để giữ ứng dụng cũ hoạt động, hãy thử thật với đúng thư viện mà ứng dụng đang dùng.
Với curl, hành vi được tài liệu ghi rõ. Không có tuỳ chọn -L thì curl không đi theo chuyển hướng nào. Có -L, curl gửi lại đúng phương thức với 307 và 308; với 301, 302 và 303 thì đổi POST thành GET giống trình duyệt, trừ khi bạn thêm --post301, --post302 hoặc --post303. Điều này làm curl trở thành công cụ tốt để mô phỏng: gửi một yêu cầu POST thử tới địa chỉ cũ với -L -v, đọc dòng phương thức ở mỗi bước.
Một lưu ý về trình duyệt rất cũ: 308 ra đời năm 2015, nên vài chương trình gọi đời cũ, thiết bị nhúng hay thư viện không còn được cập nhật có thể không nhận ra mã này và coi nó như một lỗi 3xx chung. Với các trang phục vụ người dùng phổ thông trên trình duyệt hiện đại, rủi ro này rất nhỏ. Với hệ thống tích hợp cùng thiết bị cũ, kiểm thật trước khi đổi.
Chuyển một điểm cuối API sang địa chỉ mới bằng 308
Quy trình dưới đây dành cho trường hợp bạn đổi đường dẫn API nhưng chưa kiểm soát được hết các bên đang gọi.
- Dựng điểm cuối mới song song với điểm cuối cũ, cả hai cùng xử lý được yêu cầu, kiểm điểm cuối mới bằng bộ thử của bạn.
- Cập nhật ứng dụng của chính bạn và thông báo cho các bên tích hợp gọi thẳng địa chỉ mới, kèm mốc thời gian.
- Ở điểm cuối cũ, chuyển sang trả 308 tới địa chỉ mới cho mọi phương thức, gửi kèm giới hạn bộ nhớ đệm ngắn trong giai đoạn đầu.
- Mô phỏng bằng curl với POST, PUT, DELETE và thân yêu cầu thật, ví dụ curl -L -v -X POST -d @don-thu.json tenmien.vn/v1/don-hang trên môi trường thử, đọc phương thức ở bước thứ hai.
- Theo dõi nhật ký máy chủ ở địa chỉ cũ: ai vẫn gọi, bằng phiên bản ứng dụng nào. Liên hệ những bên còn gọi nhiều.
- Khi lượt gọi tới địa chỉ cũ gần như bằng không qua một khoảng thời gian bạn chấp nhận được, quyết định giữ 308 vô thời hạn hoặc chuyển sang trả lỗi kèm thông điệp hướng dẫn.
Chọn giữa 301, 302, 307 và 308 bằng ba câu hỏi
Thay vì nhớ bảng, bạn có thể đi qua ba câu hỏi theo thứ tự mỗi khi đặt một chuyển hướng mới:
- Địa chỉ cũ có bao giờ phục vụ lại nội dung riêng không? Nếu không bao giờ, bạn đang ở nhóm vĩnh viễn (301 hoặc 308). Nếu có, hoặc nếu đích thay đổi theo thời gian hay theo người dùng, bạn ở nhóm tạm thời (302 hoặc 307).
- Có yêu cầu nào khác GET đi qua đường dẫn này không? Hãy nghĩ tới biểu mẫu, tải tệp, webhook, ứng dụng di động, máy chủ đối tác. Nếu có, chọn mã giữ phương thức: 308 cho vĩnh viễn, 307 cho tạm thời.
- Bạn muốn sau khi gửi dữ liệu thì người dùng sang một trang kết quả bằng GET? Nếu đúng, đó không phải bài toán đổi địa chỉ mà là mẫu Post/Redirect/Get, và mã đúng là 303.
- Nếu chỉ có liên kết đọc thông thường đi qua, 301 và 302 là lựa chọn quen thuộc, tương thích rộng nhất, và mọi công cụ quản trị, plugin, bảng điều khiển CDN đều hỗ trợ.
- Dù chọn mã nào, đặt ở đúng một tầng, kiểm bằng dòng lệnh, và ghi chú lý do cạnh quy tắc để người sau hiểu vì sao đường dẫn này dùng 308 thay vì 301.
Câu hỏi thứ hai hay bị bỏ qua nhất, vì người đặt quy tắc thường thử bằng trình duyệt, mà trình duyệt chỉ gửi GET khi gõ địa chỉ. Những luồng POST chỉ lộ ra khi có đơn hàng thật bị mất. Trước mỗi lần đổi quy tắc trên một đường dẫn rộng như cả tên miền, hãy hỏi người phụ trách ứng dụng và tích hợp xem có gì đang gửi dữ liệu tới đó.
Câu hỏi thường gặp
Có nên đổi toàn bộ 301 của website sang 308 không?
Không cần. Với trang web người dùng đọc qua liên kết, mọi yêu cầu đều là GET nên 301 và 308 cho kết quả như nhau, và máy tìm kiếm xử lý hai mã giống nhau. Chỉ cân nhắc 308 cho các đường dẫn nhận dữ liệu như biểu mẫu, tải tệp, API.
307 có được trình duyệt lưu lại như 301 không?
Không. 307 là mã tạm thời nên chỉ được lưu khi máy chủ gửi kèm tiêu đề cho phép rõ ràng. Đó là lý do HSTS trong trình duyệt hiển thị bước đổi sang https dưới dạng 307: nó là bước nội bộ, không phải quyết định của máy chủ cần ghi nhớ.
Webhook gửi tới site bị lỗi sau khi bật ép HTTPS là vì sao?
Bên gửi webhook có thể đang gọi địa chỉ http, nhận 301, rồi hoặc không đi theo chuyển hướng, hoặc đi theo bằng GET không có dữ liệu. Cách sửa gọn nhất là cập nhật địa chỉ webhook sang https ở phía bên gửi; trả 308 thay cho 301 là lưới an toàn tạm.
Máy chủ nginx trả 308 bằng cách nào?
Chỉ thị return trong nginx nhận bất kỳ mã nào bạn ghi, ví dụ một dòng return 308 kèm địa chỉ đích. Riêng chỉ thị rewrite với cờ permanent thì luôn trả 301, muốn 308 phải dùng return. Hãy kiểm lại tài liệu của phiên bản nginx đang chạy.
Tại sao trình duyệt hỏi xác nhận khi gặp 307 sau khi gửi biểu mẫu?
Đặc tả từ lâu khuyến nghị chương trình gọi hỏi người dùng trước khi tự gửi lại dữ liệu sang một địa chỉ khác. Một số trình duyệt hiện cảnh báo trong vài tình huống, nhất là khi gửi lại sau thao tác tải lại trang. Hành vi cụ thể khác nhau giữa các trình duyệt và phiên bản.