Web WordPress bị trắng trang: nguyên nhân và cách sửa
Cách sửa nhanh
Xoá cache của plugin cache và hosting, rồi mở lại website ở cửa sổ ẩn danh. Vẫn trắng thì bật ghi log lỗi trong wp-config.php, tải lại trang một lần và đọc dòng PHP Fatal error mới nhất trong wp-content/debug.log. Dòng đó cho biết plugin, theme hay cấu hình nào gây lỗi.
Nguyên nhân
Trang trắng là lỗi PHP làm trang dừng giữa chừng mà không hiện thông báo nào. Từ WordPress 5.2, phần lớn lỗi nghiêm trọng hiện câu “Đã có một lỗi nghiêm trọng trên trang web của bạn” thay vì trang trắng. Trang trắng hoàn toàn vẫn gặp khi lỗi xảy ra trước lúc WordPress nạp xong (ví dụ lỗi trong wp-config.php), khi trình xử lý lỗi của WordPress bị tắt, hoặc khi cache đang phục vụ một bản trang trắng đã lưu.
| Nguyên nhân | Dấu hiệu nhận biết | Cách sửa |
|---|---|---|
| Cache lưu bản trang trắng | Trang quản trị vẫn vào được, chỉ khách hoặc một số trang bị trắng | Cách 1 |
| Plugin hoặc theme lỗi | Trắng ngay sau khi cài, cập nhật; log chỉ tới wp-content/plugins/ hoặc wp-content/themes/ |
Cách 2, Cách 3 |
| Hết bộ nhớ PHP | Log có dòng Allowed memory size … exhausted |
Cách 3 |
Lỗi trong wp-config.php hoặc PHP không tương thích |
Trắng cả trang quản trị; xảy ra sau khi sửa wp-config.php hoặc đổi phiên bản PHP |
Cách 3 |
Cách 1: Xoá cache và kiểm tra lại
Plugin cache hoặc CDN có thể đã lưu lại đúng lúc trang bị lỗi và tiếp tục phục vụ bản trắng đó, dù lỗi gốc đã hết.
- Mở website ở cửa sổ ẩn danh, thử trang chủ, một bài viết và
/wp-admin/. Ghi lại trang nào trắng, trang nào bình thường. - Vào được trang quản trị thì xoá cache của plugin cache đang dùng. Với LiteSpeed Cache: rê chuột vào biểu tượng LiteSpeed trên thanh quản trị, chọn Xóa tất cả.
- Website dùng Cloudflare hoặc cache của hosting thì xoá cả cache ở đó, rồi tải lại trang ở cửa sổ ẩn danh.
Hết trắng sau khi xoá cache thì lỗi gốc đã qua. Vẫn trắng thì làm tiếp Cách 2.
Cách 2: Bật log để thấy lỗi thật
Trang trắng không cho biết gì. File log ghi lại chính xác file và dòng gây lỗi. Việc này phải sửa file wp-config.php qua File Manager, vì lúc này thường không vào được trang quản trị.
Cảnh báo: Tải bản wp-config.php hiện tại về máy trước khi sửa. Sai một dấu ngoặc trong file này cũng làm website ngừng chạy.
- Đăng nhập cPanel hoặc DirectAdmin, mở File Manager, mở
wp-config.phpở thư mục gốc website. - Thêm 3 dòng sau ngay trên dòng bắt đầu bằng
/* That's all, stop editing!rồi lưu:define( 'WP_DEBUG', true ); define( 'WP_DEBUG_LOG', true ); define( 'WP_DEBUG_DISPLAY', false ); - Tải lại trang bị trắng một lần, rồi mở file
wp-content/debug.log. Tìm dòngPHP Fatal errormới nhất. - Không thấy
debug.logthì xem mục log lỗi của hosting (thường tên Errors hoặc Error Log). Lỗi trongwp-config.phpxảy ra trước khi WordPress ghi log nên chỉ có ở log của hosting.
Cách 3: Sửa theo dòng lỗi trong log
Đối chiếu dòng lỗi với bảng dưới. Mỗi lần chỉ sửa một chỗ rồi tải lại trang để biết chắc thay đổi nào có tác dụng.
| Dòng lỗi chứa | Việc cần làm |
|---|---|
wp-content/plugins/ten-plugin/ |
Trong File Manager, đổi tên thư mục ten-plugin thành ten-plugin.off để tắt plugin đó. |
wp-content/themes/ten-theme/ |
Đổi tên thư mục theme đó. WordPress chuyển sang theme mặc định nếu website còn cài một theme Twenty Twenty-*. |
Allowed memory size … exhausted |
Nhờ hosting tăng memory_limit của PHP, hoặc tìm plugin đang dùng quá nhiều bộ nhớ. Hằng WP_MEMORY_LIMIT chỉ nâng được trong giới hạn hosting cho phép. |
syntax error và đường dẫn wp-config.php |
So sánh với bản đã tải về, sửa đúng dòng báo lỗi hoặc chép lại bản cũ lên. |
| Lỗi xuất hiện sau khi đổi phiên bản PHP | Tạm chọn lại phiên bản cũ trong mục chọn PHP của hosting, rồi cập nhật plugin, theme không tương thích. |
Làm bằng WP-CLI (SSH vào hosting, chạy trong thư mục WordPress)
wp plugin deactivate ten-plugin --skip-plugins=ten-plugin
tail -n 20 wp-content/debug.log
Kiểm tra lại
Mở website ở cửa sổ ẩn danh, kiểm tra trang chủ, một trang con và /wp-admin/. Sau đó xoá 3 dòng vừa thêm khỏi wp-config.php và xoá file debug.log, vì mặc định ai cũng mở được file này qua trình duyệt.
Đã tắt plugin hoặc theme gây lỗi thì chưa bật lại ngay. Đọc changelog, cập nhật lên bản sửa lỗi nếu có, rồi mới bật lại.
Lỗi liên quan
- There has been a critical error on this website: cách sửa
- Lỗi 500 Internal Server Error trên WordPress: cách sửa
- Cập nhật plugin WordPress thế nào để không làm sập web
Không vào được File Manager, hoặc website bán hàng đang trắng trang và mỗi giờ đều mất đơn? Cứu hộ web sửa lỗi website WordPress, gửi link để được kiểm tra miễn phí trước.