ChuyenHuong.comChuyển Hướng
Lỗi và bảo mật quanh chuyển hướng

Chuyển hướng làm mất dữ liệu POST: vì sao biểu mẫu và API hỏng sau khi ép HTTPS

Sau khi ép HTTPS hoặc đổi tên miền, biểu mẫu gửi không lưu, ứng dụng báo lỗi, webhook thanh toán thất bại? Nguyên nhân là chuyển hướng đổi POST thành GET.

Vietnamese backend developer testing an API from a laptop in a shared workspace in Thai Nguyen, coffee cup and phone nearby, laptop screen blank, side angle, neutral daylight

Khi một yêu cầu POST (gửi biểu mẫu, gọi API, webhook) gặp chuyển hướng 301 hoặc 302, trình duyệt và phần lớn thư viện HTTP sẽ gửi lại tới địa chỉ mới bằng phương thức GET và bỏ luôn phần dữ liệu. Kết quả là biểu mẫu "gửi xong mà không lưu gì", API trả lỗi 405 hoặc trả về trang chủ, còn webhook của cổng thanh toán báo thất bại. Lỗi này hay bùng lên ngay sau khi bạn ép HTTPS, chuẩn hoá www hoặc thêm dấu gạch chéo cuối đường dẫn.

Cách sửa gốc là cho mọi điểm nhận POST được gọi thẳng tới địa chỉ cuối cùng, không qua bước chuyển hướng nào. Khi không sửa được phía gửi (ứng dụng cũ đã cài trên điện thoại người dùng, đối tác chưa cập nhật), dùng mã 307 hoặc 308 để giữ nguyên phương thức và dữ liệu. Bài này giải thích cơ chế, các tình huống hay gặp, cách lần ra và cách sửa từng loại.

Mã chuyển hướng nào giữ phương thức và dữ liệu

Mấu chốt nằm ở chỗ mỗi mã chuyển hướng được quy định khác nhau về việc có được đổi phương thức hay không. Theo đặc tả HTTP hiện hành (RFC 9110) và hành vi phổ biến của trình duyệt:

MãÝ nghĩaYêu cầu POST đi tiếp thế nào
301Chuyển vĩnh viễnVì lý do lịch sử, trình duyệt và nhiều thư viện đổi sang GET, bỏ dữ liệu
302Chuyển tạm thờiNhư 301: thường đổi sang GET, bỏ dữ liệu
303Xem ở chỗ khácLuôn đổi sang GET — dùng có chủ đích sau khi xử lý xong biểu mẫu
307Chuyển tạm thời, giữ phương thứcGửi lại POST cùng dữ liệu tới địa chỉ mới
308Chuyển vĩnh viễn, giữ phương thứcGửi lại POST cùng dữ liệu tới địa chỉ mới

Hai cột cuối giải thích hầu hết sự cố. Phần lớn cấu hình ép HTTPS, chuẩn hoá www hay thêm gạch chéo cuối mặc định dùng 301, vốn không có vấn đề gì với người duyệt web bình thường vì họ chỉ gửi GET. Rắc rối chỉ xuất hiện với yêu cầu POST, PUT, PATCH, DELETE — và những yêu cầu đó thường là những thao tác quan trọng nhất: đặt hàng, thanh toán, đăng ký, cập nhật dữ liệu.

Các tình huống hay làm hỏng POST

Biểu mẫu còn trỏ tới địa chỉ http. Thuộc tính action của biểu mẫu viết cứng địa chỉ http từ hồi site chưa có chứng chỉ. Máy chủ chuyển 301 sang https, dữ liệu rơi mất, người dùng thấy trang trống hoặc quay về đầu biểu mẫu.

Khác biệt www và không www. Biểu mẫu hoặc ứng dụng gửi tới vidu.vn trong khi địa chỉ chuẩn là có www, hoặc ngược lại; bước chuẩn hoá chen vào giữa.

Dấu gạch chéo cuối. Điểm cuối API khai báo là /api/don-hang/ nhưng ứng dụng gọi /api/don-hang; khung phát triển hoặc máy chủ web tự chuyển để thêm gạch chéo.

Đổi tên miền hoặc đường dẫn API. Phiên bản ứng dụng trên điện thoại người dùng vẫn gọi tên miền cũ; quy tắc chuyển hướng toàn tên miền dùng 301.

Webhook của đối tác. Cổng thanh toán, dịch vụ gửi thư, dịch vụ vận chuyển gọi về địa chỉ bạn khai báo từ lâu. Nhiều hệ thống gửi webhook hoàn toàn không đi theo chuyển hướng, nên chỉ cần một bước 301 là mọi thông báo thất bại.

Tiêu đề xác thực bị bỏ. Khi chuyển hướng sang tên máy khác, trình duyệt và các công cụ như curl thường bỏ tiêu đề Authorization để tránh lộ thông tin, nên yêu cầu tới đích bị từ chối vì thiếu xác thực.

Lần ra chỗ chuyển hướng đang nuốt dữ liệu

Đừng sửa theo phỏng đoán. Hãy nhìn tận mắt chuỗi yêu cầu bằng các cách sau, trên môi trường thử hoặc với dữ liệu giả:

  1. Trong trình duyệt, mở tab Mạng của công cụ nhà phát triển, bật giữ nhật ký, gửi biểu mẫu. Nếu thấy dòng POST trả 301 hoặc 302 rồi tiếp theo là một dòng GET tới địa chỉ mới, bạn đã thấy thủ phạm.
  2. Với API, gửi thử bằng curl mà không cho đi theo chuyển hướng: curl -si -X POST -d "thu=1" vidu.vn/api/don-hang. Đọc dòng trạng thái và tiêu đề Location. Mã 3xx ở đây là dấu hiệu cần sửa.
  3. Nếu dùng tuỳ chọn -L để đi theo, nhớ rằng curl cũng đổi POST thành GET với 301, 302 và 303 theo mặc định; các tuỳ chọn --post301, --post302 giữ nguyên POST, chỉ dùng để thử, không phản ánh hành vi trình duyệt.
  4. Xem nhật ký truy cập máy chủ: một yêu cầu POST trả mã 301 hoặc 302, theo ngay sau là một yêu cầu GET cùng địa chỉ IP tới đích mới.
  5. Với webhook, đọc nhật ký gửi webhook trong trang quản trị của đối tác; hầu hết đều ghi mã trạng thái nhận được.

Cách sửa theo từng tình huống

Thứ tự ưu tiên: sửa phía gửi trước, ngoại lệ phía máy chủ sau. Cụ thể:

  • Biểu mẫu trên site: sửa thuộc tính action thành đường dẫn tương đối (bắt đầu bằng gạch chéo) hoặc địa chỉ https đầy đủ đúng tên miền chuẩn. Tìm trong mã, trong nội dung cơ sở dữ liệu và trong mẫu thư.
  • Webhook: vào trang quản trị của từng đối tác, cập nhật địa chỉ nhận về đúng địa chỉ cuối cùng, gửi thử một sự kiện để kiểm.
  • Ứng dụng di động, phần mềm đối tác không cập nhật ngay được: cho đường dẫn API cũ chuyển hướng bằng 308 (hoặc 307 nếu là tạm thời) thay vì 301, hoặc loại riêng đường dẫn đó khỏi quy tắc chuyển hướng và phục vụ trực tiếp.
  • Gạch chéo cuối: cấu hình khung phát triển để chấp nhận cả hai dạng cho API, hoặc thống nhất một dạng trong tài liệu và mã gọi.
  • Ép HTTPS: vẫn dùng 301 cho người duyệt web, nhưng tách quy tắc cho đường dẫn API sang 308 nếu có máy khách cũ gọi bằng http. Khi bật HSTS, trình duyệt tự nâng cấp lên https trước khi gửi nên giữ được POST, nhưng HSTS không áp dụng cho ứng dụng và máy chủ đối tác.

Cấu hình mẫu cho nginx hay Apache khác nhau, nhưng ý chung là đặt quy tắc riêng cho đường dẫn API trước quy tắc chung, trả mã 308 kèm địa chỉ mới. Thử trên môi trường thử, gửi POST bằng curl và kiểm dữ liệu đến đích, rồi mới áp lên máy thật.

Chuyển hướng có chủ đích sau khi gửi biểu mẫu: mẫu Post/Redirect/Get

Không phải chuyển hướng sau POST nào cũng xấu. Mẫu Post/Redirect/Get là cách làm chuẩn: máy chủ nhận POST, lưu dữ liệu, rồi trả mã 303 trỏ tới trang kết quả, ví dụ trang /cam-on hoặc trang chi tiết đơn hàng. Trình duyệt chuyển sang GET trang đó. Nhờ vậy, khi người dùng bấm tải lại trang, trình duyệt chỉ tải lại trang kết quả chứ không gửi lại đơn hàng lần nữa.

Điểm khác với các tình huống hỏng ở trên nằm ở thứ tự: dữ liệu đã được xử lý xong ở địa chỉ đầu tiên rồi mới chuyển hướng. Còn trong các tình huống hỏng, chuyển hướng xảy ra trước khi ứng dụng kịp đọc dữ liệu, ở tầng máy chủ web hay CDN.

Một lưu ý về CORS: với yêu cầu từ trình duyệt sang tên miền khác cần bước kiểm tra trước (preflight bằng phương thức OPTIONS), phản hồi cho bước kiểm tra phải là mã thành công. Nếu bước kiểm tra gặp chuyển hướng, trình duyệt báo lỗi CORS khó hiểu trong khi thực chất nguyên nhân là chuyển hướng. Khi thấy lỗi CORS xuất hiện ngay sau khi đổi tên miền hay ép HTTPS, hãy kiểm chuyển hướng trước khi sửa tiêu đề CORS.

Ví dụ giả định: cửa hàng ép HTTPS và mất đơn trong hai ngày

Một cửa hàng trực tuyến nhỏ ở Đồng Nai (ví dụ giả định) bật quy tắc ép HTTPS ở tầng CDN vào tối thứ Sáu, kiểm trang chủ và vài trang sản phẩm thấy chạy tốt. Sáng thứ Hai, nhân viên phát hiện hai ngày cuối tuần gần như không có đơn mới, trong khi lượt truy cập vẫn bình thường. Biểu mẫu đặt hàng nằm trong một mẫu giao diện cũ có thuộc tính action viết cứng địa chỉ http. Mỗi lần khách bấm đặt hàng, CDN trả 301 sang https, trình duyệt tải lại trang đặt hàng bằng GET, giỏ hàng vẫn còn nhưng đơn không được tạo. Khách tưởng mạng chậm, bấm vài lần rồi bỏ đi.

Cùng lúc, cổng thanh toán báo một loạt webhook thất bại vì địa chỉ nhận cũng là http. Những khách đã thanh toán chuyển khoản trực tuyến không được hệ thống ghi nhận là đã trả tiền. Cửa hàng phải đối chiếu tay từng giao dịch với sao kê và gọi lại cho khách. Bài học rút ra không phải là đừng ép HTTPS, mà là trước khi bật bất kỳ quy tắc chuyển hướng toàn site nào, cần liệt kê và kiểm mọi điểm nhận POST, rồi theo dõi số đơn và nhật ký webhook trong vài giờ đầu sau khi đổi.

Danh sách kiểm trước khi bật quy tắc chuyển hướng toàn site

Mỗi lần thêm quy tắc ép HTTPS, chuẩn hoá www, thêm gạch chéo cuối hay đổi tên miền, hãy đi qua danh sách ngắn này trước, ghi kết quả vào một bảng kiểm:

  • Liệt kê mọi biểu mẫu trên site: liên hệ, đặt hàng, đăng ký, đăng nhập, tìm kiếm, bình luận; ghi địa chỉ action của từng cái.
  • Liệt kê mọi điểm cuối API mà ứng dụng di động, phần mềm bán hàng, đối tác gọi tới, kèm phiên bản ứng dụng còn đang được dùng.
  • Liệt kê mọi địa chỉ nhận webhook đã khai báo với cổng thanh toán, dịch vụ gửi thư, đơn vị vận chuyển, nền tảng bán hàng.
  • Với mỗi điểm trên, gửi một yêu cầu POST thử bằng dữ liệu giả lên môi trường thử sau khi áp quy tắc mới, xác nhận dữ liệu tới được ứng dụng.
  • Chuẩn bị sẵn cách hoàn tác nhanh: biết tắt quy tắc ở đâu, ai có quyền tắt.
  • Sau khi áp lên máy thật, theo dõi số đơn, số đăng ký và nhật ký webhook trong vài giờ đầu, so với cùng khung giờ những ngày trước.

Danh sách này tốn chừng nửa giờ cho một site nhỏ, nhưng tiết kiệm được những ngày đối chiếu giao dịch bằng tay. Lưu nó lại cùng tài liệu vận hành để dùng cho lần đổi cấu hình sau.

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

Dùng 308 thay cho 301 cho cả site có ảnh hưởng SEO không?

Máy tìm kiếm lớn xử lý 308 tương tự 301 về mặt chuyển tín hiệu. Tuy vậy, với trang thường chỉ nhận GET thì 301 đã đủ và phổ biến hơn; dùng 308 có chủ đích cho đường dẫn nhận POST là cách rõ ràng nhất.

Vì sao gửi biểu mẫu thấy trang tải lại mà không báo lỗi gì?

Thường do POST bị chuyển hướng 301 hoặc 302 rồi trình duyệt tải trang đích bằng GET, ứng dụng không nhận được dữ liệu nên hiển thị biểu mẫu trống như lần đầu. Kiểm tab Mạng trong công cụ nhà phát triển sẽ thấy rõ.

Webhook thanh toán thất bại sau khi đổi tên miền thì xử lý thế nào?

Cập nhật ngay địa chỉ nhận webhook trong trang quản trị của cổng thanh toán về địa chỉ mới, rồi dùng tính năng gửi lại sự kiện nếu có để không sót giao dịch. Đối chiếu danh sách giao dịch trong thời gian lỗi với dữ liệu trên hệ thống.

Ứng dụng di động cũ vẫn gọi http thì có nên tắt ép HTTPS cho API không?

Không nên mở lại http không mã hoá cho dữ liệu nhạy cảm. Hãy cho đường dẫn API cũ trả 308 sang https nếu thư viện của ứng dụng đi theo chuyển hướng, đồng thời phát hành bản cập nhật và đặt lịch ngừng hỗ trợ bản cũ.

Mã 307 và 308 có được mọi trình duyệt hỗ trợ không?

Các trình duyệt hiện hành đều hỗ trợ cả hai. Một số thư viện HTTP rất cũ hoặc thiết bị nhúng có thể không xử lý đúng 308, nên nếu máy khách của bạn là phần cứng cũ, hãy thử trực tiếp trước khi đổi.

Có cách nào biết API đang bị chuyển hướng mà không đọc nhật ký không?

Gửi một yêu cầu POST bằng curl không có tuỳ chọn đi theo chuyển hướng và đọc dòng trạng thái. Có thể đưa lệnh này vào bộ kiểm tra tự động chạy sau mỗi lần đổi cấu hình máy chủ hoặc CDN để phát hiện sớm.

Cần tư vấn cụ thể cho trường hợp của bạn?

Chúng tôi sẽ liên hệ trong vòng 24 giờ.

Đăng ký tư vấn ngay

Bài viết liên quan

Bạn cần hỗ trợ thêm?

Để lại thông tin, chúng tôi sẽ liên hệ trong 24 giờ.

hoặc
Gọi ngay 0926 138 138