Các Sự cố Thường gặp với WordPress: Website bị kẹt ở chế độ bảo trì (“Stuck in Maintenance Mode”)

Nguyên nhân

Khi WordPress tiến hành cập nhật lõi, theme hoặc plugin, hệ thống sẽ tự động tạo một file có tên .maintenance trong thư mục gốc của website để kích hoạt chế độ bảo trì tạm thời.

Nếu quá trình cập nhật bị gián đoạn (mạng chậm, lỗi server, ngắt kết nối giữa chừng...), WordPress không thể tự xóa file .maintenance và website sẽ kẹt ở chế độ bảo trì, hiển thị trang trắng với thông báo dạng:

Cách khắc phục

Đây là một lỗi dễ sửa và cách duy nhất để xử lý là xóa file .maintenance theo các bước sau:

1. Truy cập vào hosting bằng File Manager (trong cPanel hoặc DirectAdmin) hoặc sử dụng FTP client (như FileZilla).
2. Vào thư mục gốc của website (thường là public_html hoặc thư mục chứa file wp-config.php).
3. Tìm file có tên .maintenance và xóa file đó.
4. Tải lại website trên trình duyệt. Website sẽ thoát khỏi chế độ bảo trì và hoạt động bình thường trở lại.

Lưu ý phòng tránh

• Luôn sao lưu website trước khi tiến hành cập nhật.
• Tránh cập nhật plugin/theme vào giờ cao điểm có nhiều người truy cập.
• Đảm bảo kết nối mạng ổn định trong suốt quá trình cập nhật.

Mẹo: Nếu lỗi vẫn không khắc phục được sau khi xóa file .maintenance, có thể cần bật chế độ gỡ lỗi (WP_DEBUG) hoặc kiểm tra log lỗi để xác định nguyên nhân khác.