Chế độ gỡ lỗi WordPress là gì?
Trong quá trình vận hành website WordPress, xung đột giữa theme và plugin là điều khó tránh khỏi. Những sự cố này đôi khi rất khó xác định nguyên nhân — website hoạt động bình thường nhưng ẩn chứa lỗi PHP chạy ngầm, hoặc một chức năng nào đó ngừng hoạt động mà không có thông báo rõ ràng.
Chế độ gỡ lỗi (Debug Mode) là tính năng tích hợp sẵn trong WordPress, cho phép hệ thống ghi lại và hiển thị toàn bộ nhật ký lỗi PHP, các cảnh báo (warnings) và thông báo (notices). Khi được bật, bạn sẽ thấy chính xác file nào, dòng code nào đang gây ra vấn đề — thay vì phải phán đoán hay thử lần lượt từng plugin.
Khi nào nên bật chế độ gỡ lỗi?
Không phải lúc nào cũng cần bật Debug Mode. Dưới đây là các tình huống điển hình mà tính năng này thực sự phát huy tác dụng:
- Website hiển thị màn hình trắng (White Screen of Death): Không có thông báo lỗi nào, nhưng trang không tải được
- Sau khi cài đặt hoặc cập nhật plugin/theme mới: Xung đột mã nguồn có thể xảy ra mà không báo trước
- Một chức năng cụ thể ngừng hoạt động: Form liên hệ, giỏ hàng, hoặc widget đột ngột mất tác dụng
- Phát triển plugin hoặc theme tùy chỉnh: Kiểm tra code trong quá trình lập trình
- Hiệu suất suy giảm không rõ nguyên nhân: Phát hiện lỗi ẩn đang tiêu tốn tài nguyên máy chủ
| Phương pháp | Phù hợp với | Yêu cầu kỹ thuật |
|---|---|---|
| Dùng Plugin WP Debugging | Người mới, không quen chỉnh file | Thấp — chỉ cài và bật |
| Chỉnh wp-config.php | Developer, người quen với hosting | Trung bình — cần truy cập File Manager |
Cách 1: Bật Debug Mode bằng Plugin (Đơn giản nhất)
Đây là lựa chọn nhanh nhất và ít rủi ro nhất, đặc biệt phù hợp với những ai không muốn chỉnh sửa file cấu hình thủ công. Plugin WP Debugging từ WordPress.org sẽ xử lý toàn bộ quá trình chỉ bằng vài thao tác đơn giản.
Các bước thực hiện
wp-config.php.
Cách 2: Bật Debug Mode qua file wp-config.php
Phương pháp này phù hợp với developer hoặc người đã quen thao tác với hosting. Nó cũng là giải pháp duy nhất khi website hoàn toàn không thể truy cập được (không vào được WordPress Admin) — bạn vẫn có thể chỉnh file trực tiếp qua File Manager của cPanel.
wp-config.php để dự phòng. Một lỗi nhỏ trong file này có thể khiến toàn bộ website ngừng hoạt động.Các bước thực hiện qua cPanel
/* That's all, stop editing! Happy publishing. */ và thêm đoạn code bên dưới phía trên dòng đó.
Đoạn code cần thêm vào wp-config.php
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );define( 'WP_DEBUG', false );, bạn chỉ cần đổi false thành true và bổ sung hai dòng còn lại bên dưới — không cần thêm dòng WP_DEBUG lần nữa.Ý nghĩa các hằng số Debug Mode
WordPress cung cấp nhiều hằng số (constants) để kiểm soát cách thức gỡ lỗi hoạt động. Hiểu rõ từng hằng số giúp bạn cấu hình phù hợp với từng tình huống.
| Hằng số | Giá trị | Tác dụng |
|---|---|---|
WP_DEBUG | true / false | Bật hoặc tắt toàn bộ chế độ gỡ lỗi |
WP_DEBUG_LOG | true / false | Ghi lỗi vào file wp-content/debug.log |
WP_DEBUG_DISPLAY | true / false | Hiển thị lỗi trực tiếp trên giao diện website (tắt khi dùng trên production) |
SCRIPT_DEBUG | true / false | Buộc WordPress tải phiên bản đầy đủ (không minified) của CSS và JS core |
SAVEQUERIES | true / false | Lưu toàn bộ truy vấn database để phân tích hiệu suất |
WP_DEBUG_DISPLAY là false và WP_DEBUG_LOG là true. Lỗi sẽ được ghi vào file log thay vì hiển thị ra ngoài, tránh lộ thông tin kỹ thuật với người dùng cuối.Cách đọc nhật ký lỗi (debug.log)
Sau khi bật Debug Mode và tái hiện lại lỗi (thực hiện lại thao tác gây ra sự cố), WordPress sẽ ghi lại thông tin lỗi để bạn phân tích. Có hai cách để đọc nhật ký này.
Đọc log bằng plugin
Nếu bạn đang sử dụng WP Debugging, hãy vào thanh menu trên cùng của trang quản trị, tìm mục Debug Quick Look → View File. Một tab mới sẽ mở ra hiển thị toàn bộ nội dung file debug.log trực tiếp trong trình duyệt.
Đọc log thủ công qua File Manager
Nếu không dùng plugin, bạn có thể truy cập file log trực tiếp trên hosting:
- Vào cPanel → File Manager
- Điều hướng đến thư mục gốc website → wp-content
- Tìm và mở file debug.log
Mỗi dòng trong file log thường có cấu trúc: [Ngày giờ] Loại lỗi: Mô tả lỗi in file [đường dẫn file] on line [số dòng]. Đây chính là thông tin bạn cần để xác định chính xác đoạn code nào đang gây vấn đề.
PHP Fatal error trước — đây là lỗi nghiêm trọng nhất. Các dòng PHP Warning và PHP Notice ít khẩn cấp hơn và thường chỉ ảnh hưởng đến hiệu suất.Tắt chế độ gỡ lỗi sau khi xử lý xong
Sau khi đã xác định và khắc phục được lỗi, việc tắt Debug Mode là bước bắt buộc — đặc biệt với website đang hoạt động công khai. Để tắt, bạn chỉ cần đổi giá trị trong wp-config.php hoặc tắt trong plugin:
define( 'WP_DEBUG', false );
define( 'WP_DEBUG_LOG', false );
define( 'WP_DEBUG_DISPLAY', false );Nếu dùng plugin WP Debugging, vào Công cụ → WP Debugging và bỏ tích chọn tùy chọn đã bật, sau đó lưu thay đổi. Bạn cũng có thể vô hiệu hóa hoặc gỡ bỏ plugin khi không cần dùng đến nữa.
Những lưu ý quan trọng khi sử dụng Debug Mode
- Không để Debug Mode bật lâu dài trên môi trường live: Thông tin lỗi PHP có thể tiết lộ cấu trúc thư mục, tên file, phiên bản plugin — những thông tin mà hacker có thể khai thác
- Luôn sao lưu trước khi chỉnh sửa wp-config.php: Một lỗi cú pháp nhỏ trong file này sẽ làm toàn bộ website ngừng hoạt động ngay lập tức
- Dùng môi trường staging để kiểm thử: Lý tưởng nhất là tái hiện lỗi trên bản staging (môi trường thử nghiệm) thay vì trực tiếp trên website thật
- Xóa hoặc làm trống file debug.log sau khi xong: File này có thể tích lũy rất nhiều dữ liệu và làm chậm hosting nếu không được quản lý
- Cân nhắc đặt SCRIPT_DEBUG = true khi phát triển: Giúp phát hiện lỗi JavaScript trong các file JS gốc của WordPress thay vì phiên bản đã minified
Tổng kết
Chế độ gỡ lỗi WordPress là công cụ không thể thiếu trong bộ công cụ của bất kỳ ai quản trị website WordPress nghiêm túc. Thay vì mò mẫm hàng giờ, bạn có thể xác định ngay nguyên nhân sự cố chỉ trong vài phút nhờ nhật ký lỗi chi tiết mà Debug Mode cung cấp.
| Tình huống | Phương pháp khuyến nghị |
|---|---|
| Người mới, không quen chỉnh code | Dùng plugin WP Debugging |
| Developer hoặc có quyền truy cập hosting | Chỉnh trực tiếp file wp-config.php |
| Website không vào được Admin | Bắt buộc dùng File Manager — chỉnh wp-config.php |
| Môi trường production (đang live) | Chỉ bật tạm thời, tắt ngay sau khi xử lý xong |
| Môi trường phát triển / staging | Có thể bật thường xuyên, thêm SCRIPT_DEBUG nếu cần |
debug.log sẽ chỉ thẳng vào vấn đề, giúp bạn tiết kiệm rất nhiều thời gian và công sức xử lý.