Lỗi màn hình trắng WordPress: 8 bước khắc phục nhanh

Xuân Dũngtác giả18 tháng 10, 20268 phút đọc

Lỗi màn hình trắng WordPress (White Screen of Death) là khi website hoặc trang quản trị chỉ hiện trang trống, hoặc thông báo “Đã xảy ra lỗi nghiêm trọng trên trang web của bạn”. Nguyên nhân phổ biến nhất là plugin hoặc giao diện xung đột sau khi cập nhật, tiếp theo là hết bộ nhớ PHP, nâng PHP mà plugin chưa tương thích, lỗi cú pháp khi sửa mã, và tệp bị hỏng.

Cách xử lý theo 8 bước: kiểm tra email chế độ khôi phục, bật nhật ký lỗi, tắt plugin, đổi giao diện mặc định, tăng bộ nhớ, quay lại phiên bản PHP, khôi phục tệp, và khôi phục bản sao lưu nếu cần.

Nguyên nhân lỗi màn hình trắng WordPress

Plugin lỗi hoặc xung đột: thường xảy ra ngay sau khi cài, cập nhật plugin.
Giao diện lỗi: cập nhật giao diện, sửa functions.php sai cú pháp.
Hết bộ nhớ PHP: thông báo “Allowed memory size exhausted” trong nhật ký.
Phiên bản PHP không tương thích: sau khi hosting nâng PHP.
Cập nhật dở dang: cập nhật bị ngắt giữa chừng, tệp thiếu, còn tệp .maintenance.
Quyền tệp sai hoặc ổ đĩa đầy.
Mã độc làm hỏng tệp.

Lỗi màn hình trắng wordpress – ảnh minh hoạ. Ảnh: Tom Swinnen / stocksnap (CC0)

8 bước sửa lỗi màn hình trắng WordPress

Bước 1: Kiểm tra email chế độ khôi phục

Từ WordPress 5.2, khi có lỗi nghiêm trọng, WordPress gửi email tới địa chỉ quản trị kèm đường dẫn vào “chế độ khôi phục” và cho biết plugin hoặc giao diện gây lỗi. Vào đường dẫn đó, tắt plugin lỗi là website chạy lại.

Bước 2: Bật nhật ký lỗi

Trong wp-config.php, bật WP_DEBUG cùng WP_DEBUG_LOG và tắt WP_DEBUG_DISPLAY để ghi lỗi vào wp-content/debug.log mà không hiện cho khách. Đọc dòng lỗi cuối để biết tệp nào, plugin nào gây ra. Tắt lại sau khi sửa. Tham khảo hướng dẫn gỡ lỗi trên WordPress.org.

Bước 3: Tắt plugin

Không vào được quản trị thì vào trình quản lý tệp của hosting, đổi tên thư mục wp-content/plugins thành plugins-off để tắt toàn bộ. Nếu website chạy lại, đổi tên về như cũ rồi tắt từng plugin (đổi tên từng thư mục con) để tìm thủ phạm.

Bước 4: Đổi sang giao diện mặc định

Đổi tên thư mục giao diện đang dùng; WordPress sẽ chuyển sang giao diện mặc định (Twenty Twenty-Five…) nếu có cài sẵn.

Bước 5: Tăng bộ nhớ PHP

Đặt WP_MEMORY_LIMIT 256M trong wp-config.php hoặc tăng memory_limit trong cấu hình PHP của hosting.

Bước 6: Quay lại phiên bản PHP trước

Nếu lỗi xuất hiện ngay sau khi đổi PHP, chọn lại phiên bản cũ trong bảng điều khiển hosting để website chạy, rồi xử lý tương thích trên staging.

Bước 7: Khôi phục tệp lõi

Xóa tệp .maintenance ở thư mục gốc nếu còn; tải lại bộ cài WordPress cùng phiên bản và chép đè thư mục wp-admin, wp-includes (không đè wp-content, wp-config.php).

Bước 8: Khôi phục bản sao lưu

Nếu vẫn không được hoặc nghi do mã độc, khôi phục bản sao lưu gần nhất trước thời điểm lỗi. Xem sao lưu WordPress.

Các lỗi gần giống lỗi màn hình trắng WordPress

Lỗi 500 Internal Server Error: thường do .htaccess sai, quyền tệp, hoặc lỗi PHP. Đổi tên .htaccess rồi vào Cài đặt → Đường dẫn tĩnh bấm Lưu để tạo lại. Lỗi “Error establishing a database connection”: sai thông tin cơ sở dữ liệu trong wp-config.php, máy chủ cơ sở dữ liệu quá tải hoặc dừng. Thông báo “Briefly unavailable for scheduled maintenance”: cập nhật bị ngắt, xóa tệp .maintenance ở thư mục gốc. Lỗi 503: máy chủ quá tải hoặc đang bảo trì, liên hệ hosting.

Trang hiển thị nhưng vỡ định dạng: không phải lỗi màn hình trắng mà thường do cache, CDN hoặc tối ưu CSS/JS; xóa cache và tắt tùy chọn gộp tệp để kiểm tra.

Phòng tránh lỗi màn hình trắng WordPress

Sao lưu tự động hằng ngày và chạy sao lưu thủ công trước mỗi lần cập nhật lớn.
Cập nhật plugin từng cái một thay vì cập nhật tất cả cùng lúc, để biết ngay plugin nào gây lỗi.
Thử cập nhật lớn, nâng PHP trên staging trước.
Không sửa mã trực tiếp trong trình sửa tệp của quản trị; tắt trình sửa tệp bằng DISALLOW_FILE_EDIT.
Dùng giao diện con cho mọi tùy biến mã.
Chọn plugin được cập nhật thường xuyên, tương thích phiên bản WordPress và PHP hiện tại.
Đảm bảo email quản trị đúng và website gửi được email để nhận thông báo chế độ khôi phục.

Thời điểm cập nhật hợp lý

Đừng cập nhật vào giờ cao điểm hay ngay trước khi nghỉ lễ. Chọn đầu giờ sáng ngày làm việc, khi có người kỹ thuật ở bên để xử lý nếu có lỗi. Với website của khách hàng dùng gói bảo trì, Việt Thái Group cập nhật theo lịch, có sao lưu trước và kiểm tra sau mỗi lần cập nhật; khi phát sinh lỗi, website được khôi phục ngay về trạng thái trước đó.

Đọc nhật ký lỗi khi gặp lỗi màn hình trắng WordPress

Một dòng lỗi PHP thường có dạng: loại lỗi (Fatal error), thông điệp, đường dẫn tệp và số dòng. Phần quan trọng nhất là đường dẫn tệp. Nếu đường dẫn chứa wp-content/plugins/ten-plugin/, plugin đó là nguyên nhân. Nếu chứa wp-content/themes/ten-giao-dien/, lỗi ở giao diện. Nếu ở wp-includes hoặc wp-admin, có thể tệp lõi bị hỏng hoặc một plugin gọi hàm sai cách.

Một số thông điệp hay gặp: “Call to undefined function” thường do plugin dùng hàm đã bị loại bỏ ở phiên bản PHP mới hoặc phụ thuộc plugin khác chưa kích hoạt; “Allowed memory size exhausted” là hết bộ nhớ; “syntax error, unexpected” là lỗi cú pháp sau khi sửa mã; “Maximum execution time exceeded” là tác vụ chạy quá lâu.

Nếu không có quyền xem tệp, hãy chụp lại thông báo và gửi cho đơn vị kỹ thuật cùng thời điểm xảy ra, thao tác vừa thực hiện trước đó (cập nhật gì, cài gì). Thông tin này rút ngắn thời gian xử lý rất nhiều.

Lỗi màn hình trắng WordPress sau khi cập nhật 7.0

Với các bản cập nhật lớn như WordPress 7.0, lỗi thường đến từ plugin hoặc giao diện cũ chưa cập nhật tương thích. Cách xử lý vẫn như trên: dùng chế độ khôi phục để tắt plugin lỗi, cập nhật plugin lên bản mới nhất, hoặc tạm thay plugin khác. Nếu cần quay lại phiên bản WordPress trước, hãy khôi phục bản sao lưu thay vì tự chép tệp, để cơ sở dữ liệu và tệp khớp nhau.

Ví dụ giả định xử lý lỗi màn hình trắng WordPress

Một cửa hàng bật tự động cập nhật plugin. Sáng hôm sau, trang chủ hiện “Đã xảy ra lỗi nghiêm trọng”. Người quản trị kiểm tra email, thấy thông báo chế độ khôi phục chỉ ra plugin bộ lọc sản phẩm. Vào đường dẫn khôi phục, tắt plugin này, website chạy lại sau 5 phút; bộ lọc tạm ẩn. Kiểm tra trang hỗ trợ của plugin thấy nhà phát triển đã ghi nhận lỗi tương thích PHP và phát hành bản sửa trong ngày. Cập nhật bản sửa trên staging, kiểm tra ổn, rồi bật lại trên website thật. Ví dụ minh hoạ quy trình, không phải sự cố của khách hàng cụ thể.

Bài học: bật tự động cập nhật cho plugin quan trọng cần đi kèm sao lưu và người theo dõi email cảnh báo.

Khi nào cần gọi chuyên gia

Hãy nhờ đơn vị kỹ thuật khi bạn không có quyền truy cập hosting, khi nhật ký lỗi chỉ tới tệp lõi hoặc nghi có mã độc, khi website là cửa hàng đang có đơn hàng, hoặc khi đã thử các bước mà không hiệu quả. Tự sửa mò trên website thật, nhất là xóa tệp hay sửa cơ sở dữ liệu, có thể biến một lỗi nhỏ thành mất dữ liệu.

Ghi lại mỗi sự cố cùng cách khắc phục vào sổ bảo trì website; lần sau gặp lỗi tương tự, người quản trị có thể tự xử lý nhanh hơn nhiều.

Câu hỏi thường gặp về lỗi màn hình trắng WordPress

Chỉ trang quản trị trắng, ngoài trang vẫn chạy?

Thường do plugin chỉ chạy trong quản trị hoặc hết bộ nhớ; làm tương tự từ bước 2.

Không nhận được email khôi phục?

Email quản trị có thể sai hoặc website không gửi được email; dùng cách đổi tên thư mục plugin.

Màn hình trắng chỉ ở một trang?

Có thể do khối, mã ngắn hoặc plugin chỉ chạy trên trang đó; xem nhật ký lỗi khi mở trang.

Kết luận về lỗi màn hình trắng WordPress

Lỗi màn hình trắng WordPress trông đáng sợ nhưng thường sửa được trong vài phút khi biết cách khoanh vùng. Xem thêm staging WordPress, phiên bản PHP cho WordPress và dịch vụ thiết kế web của Việt Thái Group.