15+ Lỗi WordPress Thường Gặp & Cách Khắc Phục Chi Tiết 2025


Bạn đã bao giờ truy cập website WordPress của mình và chỉ thấy một màn hình trắng xóa? Hay nhận được thông báo lỗi “Error Establishing a Database Connection” đầy khó hiểu? Đừng lo lắng, bạn không đơn độc. Đây là những lỗi WordPress thường gặp mà hầu hết người dùng, từ mới bắt đầu đến chuyên nghiệp, đều phải đối mặt ít nhất một lần.

Bài viết này sẽ là cẩm nang toàn diện, tổng hợp hơn 15 lỗi phổ biến nhất và hướng dẫn bạn cách khắc phục từng bước một cách an toàn và hiệu quả.

Quan trọng: 2 Việc Cần Làm Trước Khi Sửa Lỗi WordPress

Trước khi thực hiện bất kỳ thay đổi nào, hãy đảm bảo bạn đã thực hiện hai bước quan trọng sau để bảo vệ dữ liệu của mình:

  1. Sao lưu (Backup) toàn bộ website: Đây là bước BẮT BUỘC. Một bản backup đầy đủ (bao gồm cả file và database) là tấm vé bảo hiểm giúp bạn có thể khôi phục lại trang web nếu có sự cố xảy ra trong quá trình sửa lỗi.
  2. Sử dụng môi trường Staging (nếu có): Staging là một bản sao của website chính, nơi bạn có thể thử nghiệm các thay đổi mà không ảnh hưởng đến trang web đang hoạt động. Nếu nhà cung cấp hosting của bạn hỗ trợ tính năng này, hãy tận dụng nó.

15+ Lỗi WordPress Thường Gặp và Hướng Dẫn Khắc Phục

1. Lỗi Màn hình trắng (White Screen of Death – WSoD)

Đây là một trong những lỗi đáng sợ nhất, khi trang web của bạn chỉ hiển thị một màu trắng trơn mà không có bất kỳ thông báo lỗi nào.

  • Nguyên nhân phổ biến: Xung đột plugin hoặc theme, lỗi file functions.php, hoặc hết giới hạn bộ nhớ PHP.
  • Cách khắc phục:
    1. Vô hiệu hóa tất cả plugin: Truy cập hosting qua FTP hoặc File Manager, đổi tên thư mục wp-content/plugins thành plugins_old. Nếu website hoạt động trở lại, hãy đổi tên thư mục lại như cũ và kích hoạt lại từng plugin để tìm ra thủ phạm.
    2. Chuyển sang theme mặc định: Tương tự như trên, hãy đổi tên thư mục theme bạn đang dùng (trong wp-content/themes) để WordPress tự động chuyển về theme mặc định (ví dụ: Twenty Twenty-Four).
    3. Tăng giới hạn bộ nhớ PHP: Xem hướng dẫn ở lỗi số 3.
    4. Bật chế độ gỡ lỗi (Debug Mode): Mở file wp-config.php và tìm dòng define( 'WP_DEBUG', false );. Thay false thành true. WordPress sẽ hiển thị các lỗi cụ thể thay vì màn hình trắng, giúp bạn xác định vấn đề.

2. Lỗi Kết nối Cơ sở dữ liệu (Error Establishing a Database Connection)

Lỗi này cho thấy website của bạn không thể kết nối với cơ sở dữ liệu (database), nơi lưu trữ toàn bộ nội dung.

  • Nguyên nhân phổ biến: Sai thông tin kết nối database trong file wp-config.php, database bị lỗi, hoặc máy chủ database không phản hồi.
  • Cách khắc phục:
    1. Kiểm tra file wp-config.php: Đảm bảo DB_NAME, DB_USER, DB_PASSWORD, và DB_HOST là chính xác. Bạn có thể tìm thông tin này trong khu vực quản lý hosting của mình.
    2. Kiểm tra máy chủ database: Liên hệ nhà cung cấp hosting để hỏi xem máy chủ MySQL có đang hoạt động bình thường không.
    3. Sửa chữa database: Thêm dòng define('WP_ALLOW_REPAIR', true); vào file wp-config.php. Sau đó, truy cập vào đường dẫn your-site.com/wp-admin/maint/repair.php và làm theo hướng dẫn. Nhớ xóa dòng code này sau khi hoàn tất.

3. Lỗi Hết Bộ nhớ (Fatal Error: Allowed Memory Size Exhausted)

Lỗi này xảy ra khi một tập lệnh hoặc plugin yêu cầu nhiều bộ nhớ (RAM) hơn mức được cấp phép trên hosting của bạn.

  • Triệu chứng: Website hiển thị lỗi trắng trang kèm thông báo “Fatal Error: Allowed Memory Size Of XXX Bytes Exhausted”.
  • Cách khắc phục: Tăng giới hạn bộ nhớ PHP bằng một trong các cách sau:
    • Sửa file wp-config.php: Thêm dòng sau vào trước dòng /* That's all, stop editing! Happy publishing. */: php define('WP_MEMORY_LIMIT', '256M');
    • Sửa file .htaccess: Thêm dòng sau vào file .htaccess ở thư mục gốc: php_value memory_limit 256M
    • Nếu cả hai cách trên không hiệu quả, bạn cần liên hệ nhà cung cấp hosting để yêu cầu họ tăng giới hạn bộ nhớ.

4. Lỗi 404 Not Found Khi Xem Bài Viết

Lỗi này xảy ra khi bạn có thể truy cập trang chủ nhưng không thể xem các trang con hoặc bài viết, thay vào đó là thông báo lỗi 404.

  • Nguyên nhân phổ biến: Cài đặt đường dẫn tĩnh (Permalink) bị lỗi hoặc file .htaccess bị thiếu/sai cấu hình.
  • Cách khắc phục:
    1. Cập nhật lại Permalinks: Vào Dashboard -> Settings -> Permalinks và chỉ cần nhấn nút Save Changes mà không cần thay đổi gì. Thao tác này sẽ tự động tạo lại file .htaccess.
    2. Sửa file .htaccess thủ công: Nếu cách trên không được, hãy kiểm tra file .htaccess trong thư mục gốc của website. Đảm bảo nó chứa đoạn mã mặc định của WordPress: # BEGIN WordPress <IfModule mod_rewrite.c> RewriteEngine On RewriteBase / RewriteRule ^index\.php$ - [L] RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule . /index.php [L] </IfModule> # END WordPress

5. Lỗi Chế độ Bảo trì (Briefly Unavailable For Scheduled Maintenance)

Thông báo này thường xuất hiện khi bạn đang cập nhật WordPress, theme hoặc plugin. Đôi khi, nó không tự biến mất sau khi cập nhật xong.

  • Nguyên nhân: Quá trình cập nhật bị gián đoạn, khiến WordPress không thể xóa file .maintenance.
  • Cách khắc phục: Truy cập vào hosting qua FTP hoặc File Manager, tìm và xóa file có tên là .maintenance trong thư mục gốc của website. Trang web của bạn sẽ hoạt động trở lại ngay lập tức.

6. Lỗi Cảnh báo Header (Warning: Cannot Modify Header Information)

Lỗi này thường xuất hiện ở đầu trang web, báo rằng headers already sent by....

  • Nguyên nhân: Có khoảng trắng, ký tự lạ hoặc mã HTML trước thẻ <?php ở đầu một file PHP nào đó (thường là wp-config.php hoặc functions.php).
  • Cách khắc phục: Mở file được chỉ định trong thông báo lỗi, xóa mọi khoảng trắng hoặc ký tự thừa ở trước thẻ <?php và sau thẻ ?> (nếu có).

7. Bị Hỏi Tài Khoản FTP Khi Cài Theme/Plugin

Lỗi hỏi FTP khi cài theme-plugin

WordPress yêu cầu thông tin FTP khi nó không có quyền ghi trực tiếp vào thư mục wp-content.

  • Nguyên nhân: Vấn đề về phân quyền (permission) trên hosting.
  • Cách khắc phục: Thêm dòng sau vào file wp-config.php: php define( 'FS_METHOD', 'direct' ); Nếu vẫn không được, bạn cần liên hệ hosting để kiểm tra và CHMOD lại quyền cho các thư mục WordPress.

8. Lỗi Upload Ảnh (Unable to create directory wp-content/uploads…)

lỗi thường gặp trong WordPress

Lỗi này xảy ra khi bạn không thể tải ảnh hoặc file lên Media Library.

  • Nguyên nhân: Thư mục wp-content/uploads không có quyền ghi.
  • Cách khắc phục: Dùng FTP hoặc File Manager, CHMOD (thay đổi quyền) cho thư mục wp-content và thư mục uploads bên trong nó thành 755. Đảm bảo áp dụng cho cả các thư mục con.

9. Lỗi Thiếu Stylesheet (Stylesheet Is Missing)

stylesheet-missing-wordpress

Lỗi này xuất hiện khi bạn cài đặt một theme mới và nhận được thông báo “The package could not be installed. The theme is missing the style.css stylesheet.”

  • Nguyên nhân: Bạn đã upload file nén sai. Thông thường, file bạn tải về chứa cả thư mục theme, tài liệu, plugin đi kèm… Bạn cần giải nén file đó ra và chỉ upload file .zip chứa theme bên trong.
  • Cách khắc phục: Giải nén file theme bạn đã tải về. Tìm thư mục chứa các file của theme (có file style.css bên trong), nén thư mục đó lại thành một file .zip mới và upload lên WordPress.

10. Lỗi PCLZIPERRBAD_FORMAT (-10)

wptheme-rar-problem

Đây là một lỗi khác liên quan đến việc upload theme/plugin.

  • Nguyên nhân: Bạn đang cố gắng upload một file không phải định dạng .zip (ví dụ: .rar, .7z). WordPress chỉ hỗ trợ tự động giải nén cho file .zip.
  • Cách khắc phục: Đơn giản là hãy giải nén file trên máy tính của bạn và nén lại dưới định dạng .zip trước khi upload.

11. Lỗi Internal Server Error (Lỗi 500)

Đây là một lỗi chung chung, cho biết có sự cố trên máy chủ nhưng không chỉ rõ nguyên nhân.

  • Nguyên nhân phổ biến: Lỗi file .htaccess, xung đột plugin/theme, hết bộ nhớ PHP.
  • Cách khắc phục: Thực hiện tương tự như khi sửa lỗi màn hình trắng: kiểm tra file .htaccess, vô hiệu hóa plugin, chuyển theme, và tăng giới hạn bộ nhớ.

12. Lỗi Cú pháp (Syntax Error)

Lỗi này thường xảy ra sau khi bạn sao chép và dán một đoạn mã vào file functions.php hoặc file khác.

  • Nguyên nhân: Thiếu dấu chấm phẩy, dấu ngoặc nhọn hoặc sai cú pháp PHP.
  • Cách khắc phục: Thông báo lỗi sẽ chỉ rõ file và dòng bị lỗi. Hãy truy cập file đó qua FTP và sửa lại cú pháp cho đúng. Nếu không chắc chắn, hãy xóa đoạn mã bạn vừa thêm vào.

13. Lỗi RSS Feed

Lỗi RSS feed có thể ngăn người dùng đăng ký nhận tin mới từ website của bạn qua các trình đọc RSS.

  • Nguyên nhân: Lỗi định dạng XML, thường do một khoảng trắng thừa sau thẻ ?> trong một file PHP.
  • Cách khắc phục: Vô hiệu hóa các plugin liên quan đến RSS. Kiểm tra file functions.php và các file template của theme xem có khoảng trắng thừa không.

14. Lỗi “Are you sure you want to do this?”

Lỗi này thường xuất hiện khi kiểm tra Nonce (một mã bảo mật) thất bại.

  • Nguyên nhân: Một plugin hoặc theme không sử dụng Nonce đúng cách.
  • Cách khắc phục: Vô hiệu hóa tất cả plugin và chuyển về theme mặc định để xác định thành phần gây lỗi.

15. Lỗi Quá nhiều chuyển hướng (Too Many Redirects)

Lỗi này khiến trình duyệt bị kẹt trong một vòng lặp chuyển hướng vô tận.

  • Nguyên nhân: Cài đặt sai trong phần URL WordPress hoặc URL Trang web, hoặc do một plugin SEO/chuyển hướng cấu hình sai.
  • Cách khắc phục:
    1. Vào Settings -> General, kiểm tra xem WordPress Address (URL)Site Address (URL) có giống nhau không. Đảm bảo chúng có hoặc không có www một cách nhất quán.
    2. Vô hiệu hóa các plugin liên quan đến chuyển hướng hoặc SEO để kiểm tra.

Câu Hỏi Thường Gặp (FAQ)

1. Sửa lỗi WordPress có làm mất dữ liệu không? Nếu bạn làm theo đúng hướng dẫn và đặc biệt là đã tạo bản sao lưu (backup) trước khi bắt đầu, nguy cơ mất dữ liệu là rất thấp. Backup chính là mạng lưới an toàn của bạn.

2. Làm thế nào để bật chế độ gỡ lỗi (debug mode) trong WordPress? Bạn cần mở file wp-config.php trong thư mục gốc của website, tìm dòng define( 'WP_DEBUG', false ); và thay false thành true. Điều này sẽ hiển thị các lỗi PHP chi tiết trên trang web của bạn, giúp việc chẩn đoán dễ dàng hơn. Nhớ tắt nó đi (false) sau khi đã sửa lỗi xong.

3. Nếu tôi không thể tự sửa được lỗi, tôi nên làm gì? Nếu bạn đã thử các cách trên mà vẫn không thành công, đừng ngần ngại tìm đến sự giúp đỡ. Bạn có thể: liên hệ bộ phận hỗ trợ của nhà cung cấp hosting, nhờ một lập trình viên WordPress, hoặc liên hệ các đơn vị chuyên nghiệp.


Việc xử lý các lỗi thường gặp trong WordPress không còn là cơn ác mộng nếu bạn hiểu rõ nguyên nhân và có quy trình khắc phục đúng đắn. Hy vọng bài viết này đã cung cấp cho bạn những kiến thức cần thiết để tự tin quản lý website của mình.

Nếu bạn đang tìm kiếm một giải pháp website chuyên nghiệp, ổn định và được tối ưu ngay từ đầu để hạn chế tối đa lỗi, hãy tham khảo dịch vụ Thiết Kế Website của chúng tôi. Ngoài ra, bạn có thể tìm hiểu thêm các thủ thuật WordPress hữu ích khác để làm chủ website của mình.

Chúc các bạn thành công!

4.8/5 - (99 bình chọn)
4.8/5 - (99 bình chọn)