WordPress bị vòng lặp chuyển hướng ngay sau khi cài hoặc cập nhật plugin thường là do hai thành phần cùng chuyển hướng một địa chỉ theo hai quy tắc khác nhau: một plugin với lõi WordPress, hai plugin với nhau, hoặc plugin với quy tắc máy chủ. Các loại hay dính là plugin ép SSL, plugin quản lý chuyển hướng, plugin SEO có tính năng chuẩn hoá đường dẫn, và plugin bộ nhớ đệm lưu nhầm câu trả lời chuyển hướng.
Bài này chỉ cách tắt plugin khi không vào được trang quản trị, cách dùng tiêu đề X-Redirect-By mà WordPress gắn vào để biết thành phần nào đang chuyển hướng, cơ chế chuyển hướng chuẩn của lõi WordPress mà nhiều người không biết là có, và cách quyết định giữ plugin nào. Các bước làm trên một site WordPress đơn lẻ; site nhiều site con (multisite) có thêm vài lưu ý ở cuối bài.
Tắt plugin khi không vào được trang quản trị
Khi trang đăng nhập cũng quay vòng, bạn cần tắt plugin từ bên ngoài WordPress. Có ba cách, chọn theo quyền bạn có:
- Qua trình quản lý tệp của hosting hoặc kết nối SFTP: vào thư mục wp-content, đổi tên thư mục plugins thành plugins-tat. WordPress không tìm thấy plugin nào nên tự coi tất cả là đã tắt. Thử tải lại site.
- Nếu site chạy lại, đổi tên thư mục về plugins. Lúc này các plugin vẫn ở trạng thái tắt trong danh sách; vào trang quản trị và bật lại từng cái, mỗi lần bật thì mở site ở cửa sổ ẩn danh để kiểm.
- Nếu muốn tắt riêng một plugin nghi ngờ thay vì tất cả, đổi tên thư mục của riêng plugin đó bên trong wp-content/plugins.
- Nếu có quyền dòng lệnh và công cụ WP-CLI, lệnh wp plugin deactivate --all tắt toàn bộ, lệnh wp plugin list xem trạng thái. Cách này không động vào tên thư mục nên gọn hơn.
- Nếu chỉ có quyền vào cơ sở dữ liệu, dòng active_plugins trong bảng tuỳ chọn giữ danh sách plugin đang bật dưới dạng dữ liệu tuần tự hoá. Sao lưu, rồi sửa giá trị đó thành một mảng rỗng tuần tự hoá. Cách này dễ sai, chỉ dùng khi không còn cách nào khác.
Đừng xoá plugin khi đang mò lỗi. Nhiều plugin chuyển hướng giữ bảng quy tắc riêng trong cơ sở dữ liệu; xoá plugin có thể xoá luôn bảng đó, kể cả các chuyển hướng đúng bạn cần giữ cho địa chỉ cũ.
Đọc tiêu đề X-Redirect-By để biết ai đang chuyển hướng
Từ phiên bản 5.1, hàm chuyển hướng của WordPress gắn thêm tiêu đề X-Redirect-By vào phản hồi, giá trị mặc định là WordPress. Plugin viết đúng chuẩn sẽ truyền tên của nó vào tham số tương ứng, nên tiêu đề sẽ ghi tên plugin. Đây là manh mối rẻ nhất để biết bước chuyển hướng nào do ai trả về, nhất là khi có nhiều plugin cùng làm việc này.
Cách đọc: chạy curl -sI https://vidu.vn/duong-dan-bi-loi không kèm -L để chỉ lấy một bước, nhìn tiêu đề X-Redirect-By. Nếu có tên plugin, bạn đã có nghi phạm. Nếu ghi WordPress, bước đó do lõi hoặc do plugin không khai tên. Nếu không có tiêu đề này, bước chuyển hướng không đi qua hàm chuyển hướng của WordPress: có thể từ máy chủ web, từ CDN, hoặc từ plugin tự gửi tiêu đề Location bằng hàm PHP thô.
Lặp lại với địa chỉ ở bước kế tiếp trong vòng. Hai bước liền nhau mang hai tên khác nhau là bức tranh rõ ràng về hai thành phần đang giằng co. Ghi lại tên và hướng chuyển của từng bước; thông tin này đủ để quyết định tắt tính năng nào mà không phải tắt cả plugin.
Chuyển hướng chuẩn của lõi WordPress
WordPress tự chuyển hướng về địa chỉ chuẩn. Hàm redirect_canonical trong lõi so địa chỉ được yêu cầu với địa chỉ mà WordPress coi là chuẩn cho nội dung đó: thêm hoặc bỏ dấu gạch chéo cuối theo cấu trúc đường dẫn đã chọn, chuyển dạng có tham số ?p=123 sang đường dẫn đẹp, sửa tên miền theo địa chỉ trang đã lưu. Nhiều người chỉ biết điều này khi nó đánh nhau với một quy tắc khác.
Nó đoán cả địa chỉ gần đúng. Khi địa chỉ không khớp nội dung nào, WordPress có thể đoán một bài có đường dẫn gần giống và chuyển tới đó. Tính năng này hữu ích với lỗi gõ nhưng có lúc đưa người dùng tới bài không liên quan, hoặc xung đột với plugin chuyển hướng đang muốn trả 404 hay chuyển nơi khác.
Plugin SEO cũng có lớp chuẩn hoá riêng. Một số plugin SEO thêm tuỳ chọn bỏ tham số lạ, ép dấu gạch chéo, hoặc chuyển hướng trang đính kèm về bài gốc. Khi lõi và plugin cùng chuẩn hoá theo quy ước khác nhau, ví dụ một bên muốn có gạch chéo cuối và bên kia không, vòng lặp xuất hiện ở đúng loại trang đó.
Tắt một phần thay vì tắt cả. Lập trình viên có thể tắt chuyển hướng chuẩn cho từng loại yêu cầu bằng bộ lọc redirect_canonical trong plugin riêng của site. Chỉ làm khi đã hiểu rõ quy tắc nào sẽ thay thế, vì tắt hẳn làm mất phần chuẩn hoá có ích.
Các loại plugin hay gây vòng lặp
Mỗi loại plugin có kiểu xung đột riêng. Bảng giúp bạn đoán nhanh khi đã biết site có những plugin nào.
| Loại plugin | Kiểu xung đột thường gặp | Hướng xử lý |
|---|---|---|
| Ép SSL, sửa nội dung hỗn hợp | Thấy http ở chặng sau CDN hoặc proxy nên ép https mãi | Sửa kết nối về máy chủ cho đúng https; khi ổn định có thể gỡ plugin |
| Quản lý chuyển hướng | Quy tắc A sang B và B sang A nhập ở hai thời điểm; quy tắc biểu thức chính quy bắt cả địa chỉ đích | Xuất danh sách quy tắc, tìm cặp ngược chiều và quy tắc tự khớp |
| SEO có chuẩn hoá đường dẫn | Dấu gạch chéo cuối, tham số truy vấn, tên miền ngược với lõi hoặc máy chủ | Tắt riêng tính năng chuẩn hoá trùng với nơi khác |
| Bộ nhớ đệm trang | Lưu câu trả lời chuyển hướng tạm thời rồi phát lại cho mọi người | Xoá bộ nhớ đệm; loại các trang có chuyển hướng khỏi bộ nhớ đệm |
| Đa ngôn ngữ | Chuyển theo cookie hay ngôn ngữ trình duyệt, xung đột với đường dẫn chuẩn | Kiểm cài đặt phát hiện ngôn ngữ, thử khi tắt cookie |
| Bảo mật, đổi đường dẫn đăng nhập | Đường dẫn đăng nhập mới bị plugin khác chuyển về đường dẫn cũ | Tạm tắt tính năng đổi đường dẫn, kiểm lại quy tắc |
Plugin quản lý chuyển hướng đáng được soát kỹ nhất vì nó tích luỹ quy tắc qua nhiều năm và nhiều người nhập. Một quy tắc dùng biểu thức chính quy viết lỏng, ví dụ khớp mọi địa chỉ bắt đầu bằng /san-pham và chuyển sang /san-pham/, sẽ khớp luôn chính địa chỉ đích và tự quay vòng.
Quyết định giữ plugin nào
Sau khi tìm ra cặp xung đột, đừng vội chọn theo cảm tính. Vài nguyên tắc giúp chọn đúng và giảm số plugin phải bảo trì:
- Chuẩn hoá giao thức và www nên giao cho máy chủ web hoặc CDN, không cần plugin. Nếu plugin ép SSL đang làm việc này, gỡ nó sau khi tầng ngoài đã đảm nhận.
- Chuyển hướng theo nội dung, như bài đổi đường dẫn, danh mục gộp, nên ở một plugin duy nhất có bảng quy tắc và nhật ký. Đừng để hai plugin cùng giữ bảng chuyển hướng.
- Nếu plugin SEO và plugin chuyển hướng đều có tính năng chuyển hướng, chọn một nơi và tắt tính năng ở nơi kia, ghi lại lựa chọn.
- Plugin bộ nhớ đệm phải được cấu hình không lưu phản hồi 3xx, hoặc chỉ lưu chuyển hướng 301 đã chắc chắn. Kiểm tài liệu của plugin bạn dùng vì mỗi plugin mặc định khác nhau.
- Sau mỗi lần cập nhật plugin lớn, chạy lại bảng kiểm các biến thể địa chỉ. Cập nhật đôi khi bật sẵn tính năng mới mà bạn không để ý.
Thử trên bản sao trước khi đụng site thật
Khi site đang chạy kinh doanh, mỗi lần tắt bật plugin trên bản thật là một lần khách có thể gặp trang lỗi. Nếu hosting có tính năng tạo bản thử nghiệm, hoặc bạn tự dựng được một bản sao ở tên miền phụ, hãy tái hiện vòng lặp ở đó trước. Bản sao cần cùng phiên bản WordPress, cùng danh sách plugin và cùng cấu hình máy chủ; khác một trong ba thứ là có thể không tái hiện được lỗi.
Khi dựng bản sao, nhớ rằng địa chỉ trang trong cơ sở dữ liệu vẫn là địa chỉ thật. Nếu không thay, bản sao sẽ chuyển hướng ngược về site thật và bạn tưởng nhầm là đã tái hiện được vòng lặp. Thay địa chỉ bằng công cụ tìm và thay xử lý được dữ liệu tuần tự hoá, và chặn máy tìm kiếm vào bản sao bằng mật khẩu thư mục thay vì chỉ dựa vào tệp robots.
Trên bản sao, bạn tự do tắt từng plugin, đổi tuỳ chọn, xem nhật ký. Khi tìm ra cấu hình đúng, ghi lại từng thay đổi rồi áp lên site thật theo đúng thứ tự, mỗi bước kiểm bằng curl. Cách này chậm hơn sửa thẳng chừng nửa giờ, nhưng thời gian site thật bị lỗi giảm còn vài phút. Với cửa hàng trực tuyến đang có đơn, đổi như vậy thường đáng.
Lưu ý với multisite và site nằm sau proxy
Với WordPress multisite, mỗi site con có địa chỉ riêng trong bảng của nó, và mạng có thêm hằng số DOMAIN_CURRENT_SITE trong tệp cấu hình. Vòng lặp thường do một site con được ánh xạ tên miền riêng nhưng địa chỉ trong bảng vẫn là dạng tên miền phụ cũ, hoặc do cookie đăng nhập đặt theo tên miền mạng không khớp tên miền site con. Kiểm từng bảng tuỳ chọn của site con, đừng chỉ kiểm site chính.
Với site nằm sau CDN, bộ cân bằng tải hay proxy ngược, WordPress chỉ biết yêu cầu là https nếu biến HTTPS của PHP bằng on. Nếu chặng cuối là http, nhiều hướng dẫn thêm vào wp-config.php một đoạn đặt biến HTTPS thành on khi tiêu đề X-Forwarded-Proto bằng https. Đoạn này chỉ an toàn khi máy chủ chỉ nhận kết nối từ proxy tin cậy; nếu không, bất kỳ ai cũng gửi được tiêu đề đó. Cách bền hơn là để chặng cuối chạy https thật.
Câu hỏi thường gặp
Đổi tên thư mục plugins có làm mất cài đặt của plugin không?
Không. Cài đặt nằm trong cơ sở dữ liệu, không nằm trong thư mục. Khi đổi tên lại và bật plugin, cài đặt cũ vẫn còn. Chỉ có trạng thái bật hay tắt bị đặt lại, nên bạn phải bật lại từng plugin.
Tắt hết plugin rồi mà vẫn vòng lặp thì sao?
Lỗi nằm ngoài plugin: ở địa chỉ trang đã lưu, ở .htaccess, ở cấu hình máy chủ hoặc CDN. Thử chuyển sang giao diện mặc định của WordPress vì giao diện cũng có thể chứa mã chuyển hướng, rồi kiểm tiếp các tầng ngoài.
Plugin không ghi tên vào X-Redirect-By thì làm sao biết?
Bật lại từng plugin và kiểm sau mỗi lần là cách chắc nhất. Nếu có môi trường thử nghiệm, có thể tìm trong mã nguồn plugin các lệnh gọi hàm chuyển hướng hoặc gửi tiêu đề Location để khoanh vùng nhanh hơn.
Vòng lặp chỉ xảy ra khi đã đăng nhập thì do đâu?
Nhiều plugin bộ nhớ đệm bỏ qua người đã đăng nhập, nên hai nhóm người dùng đi qua hai đường khác nhau. Cũng có thể do plugin bảo mật hay plugin thành viên chuyển hướng theo vai trò. Kiểm bằng hai trình duyệt, một đăng nhập và một không.
Có nên dùng plugin để ép https không?
Có thể dùng tạm khi chưa sửa được cấu hình máy chủ, nhưng lâu dài nên để máy chủ web hoặc CDN làm. Plugin chạy sau khi WordPress đã nạp, nên mỗi chuyển hướng tốn tài nguyên hơn, và nó dễ đánh nhau với tầng ngoài.