Cách khắc phục lỗi Scrape key check failed trên WordPress (Thành công 100%)
Th3
Trong quá trình quản trị website WordPress, nhiều người dùng có thể gặp lỗi Scrape key check failed khiến giao diện hoặc một số chức năng không hoạt động bình thường. Đây là lỗi khá phổ biến khi chỉnh sửa code hoặc can thiệp vào file hệ thống, nhưng lại dễ gây hoang mang nếu không hiểu rõ nguyên nhân. Việc nắm được bản chất lỗi và cách phòng tránh sẽ giúp bạn quản lý website ổn định và an toàn hơn.
Lỗi Scrape key check failed là gì?
Lỗi “Scrape key check failed. Please try again” trên WordPress là một cơ chế bảo mật được thiết kế để ngăn việc chỉnh sửa mã nguồn trực tiếp từ giao diện quản trị trong Theme File Editor hoặc Plugin Editor. Khi xảy ra lỗi, hệ thống không thể xác thực khóa bảo mật (scrape key), dẫn đến việc chặn thao tác lưu thay đổi nhằm bảo vệ website.
Thông thường, lỗi này xuất hiện trên các phiên bản WordPress từ 5.x trở lên do thay đổi về cơ chế bảo mật, hoặc có thể bị kích hoạt bởi xung đột plugin, cache trình duyệt, hoặc phiên đăng nhập đã hết hạn.
Hướng dẫn sửa lỗi “Scrape key check failed. Please try again” trên WordPress
Lỗi Scrape key check failed thường xuất hiện trên các phiên bản WordPress mới (5.x, 6.x trở lên) khi bạn cố gắng chỉnh sửa file theme hoặc plugin trực tiếp trong Appearance → Theme Editor hoặc Plugin Editor. Đây là cơ chế bảo mật mới của WordPress nhằm hạn chế chỉnh sửa code trực tiếp từ giao diện quản trị.
Nếu bạn vẫn cần khôi phục chức năng này có thể xử lý theo cách sau:
Truy cập vào server chứa mã nguồn WordPress
Trước tiên, bạn cần đăng nhập vào hosting hoặc server đang lưu trữ website.
- Sử dụng FTP (FileZilla), File Manager của hosting hoặc SSH.
- Tìm đến thư mục cài đặt WordPress.
- Vào đường dẫn:
wp-admin/
Trong thư mục này, bạn sẽ cần chỉnh sửa file file.php.
Chỉnh sửa file file.php trong wp-admin
Mở file theo đường dẫn:
wp-admin/file.php
Sau đó thực hiện:
- Dùng chức năng tìm kiếm (Ctrl + F) và tìm dòng chứa:
if ( $is_active && 'php' === $extension ) - Tiến hành comment hoặc xóa điều kiện này.
- Thay bằng đoạn code sau:
if ( $is_active && 'php' === $extension && false ) {Việc thêm && false sẽ vô hiệu hóa điều kiện kiểm tra này.
Lưu file và kiểm tra lại
Sau khi chỉnh sửa:
- Lưu lại file
file.php. - Quay lại WordPress và thử truy cập Theme Editor hoặc Plugin Editor.
- Nếu thực hiện đúng, lỗi “Scrape key check failed” sẽ không còn xuất hiện và bạn có thể chỉnh sửa file như bình thường.
Lưu ý quan trọng:
- Việc chỉnh sửa file core của WordPress có thể gây rủi ro bảo mật hoặc lỗi hệ thống nếu làm sai.
- Nên sao lưu website (backup) trước khi thực hiện.
- Khuyến nghị sử dụng child theme hoặc plugin riêng để chỉnh sửa code thay vì sửa trực tiếp trong Theme Editor.
Những lưu ý quan trọng để tránh lỗi Scrape key check failed
Lỗi Scrape key check failed thường xảy ra khi hệ thống không đọc được file hoặc code bị sai cấu trúc, gây gián đoạn hoạt động website. Để hạn chế tình trạng này, bạn cần tuân thủ các nguyên tắc sau:
- Không chỉnh sửa trực tiếp trong Theme Editor của WordPress vì chỉ một lỗi nhỏ trong code cũng có thể khiến website bị trắng trang và không truy cập được Dashboard.
- Luôn sao lưu (backup) toàn bộ website hoặc ít nhất là file cần chỉnh sửa trước khi can thiệp vào các file quan trọng như
functions.phphay.htaccessđể có thể khôi phục khi xảy ra lỗi. - Ưu tiên sử dụng FTP hoặc File Manager của hosting để chỉnh sửa, giúp bạn dễ dàng tải file về máy, sửa bằng công cụ chuyên dụng và khôi phục nhanh nếu có sự cố.
- Sử dụng Child Theme thay vì chỉnh sửa theme gốc để tránh mất tùy chỉnh khi cập nhật theme và giảm nguy cơ phát sinh lỗi hệ thống.
Lỗi Scrape key check failed không quá phức tạp nhưng có thể gây ảnh hưởng lớn nếu không xử lý đúng cách. Thay vì sửa chữa trong tình trạng bị động, bạn nên xây dựng thói quen làm việc an toàn như backup thường xuyên, sử dụng Child Theme và hạn chế chỉnh sửa trực tiếp trên hệ thống. Điều này sẽ giúp website hoạt động ổn định và giảm thiểu tối đa rủi ro trong quá trình vận hành.
