Hướng dẫn khắc phục lỗi Redis Object Cache không kết nối trong WordPress

Article ID: 1226

Cập nhật gần nhất: 30 Th10, 2025

1. Giới thiệu

Redis Object Cache là plugin phổ biến giúp tăng tốc độ WordPress bằng cách lưu trữ dữ liệu tạm trong bộ nhớ RAM, giảm tải cho MySQL và tăng tốc độ phản hồi của website.
Tuy nhiên, nhiều người dùng gặp tình trạng plugin hiển thị lỗi:

Redis is unreachable: Connection refused [tcp://127.0.0.1:6379]
hoặc

Redis is not enabled / not reachable

mặc dù đã bật Redis trên hosting.

Bài viết này hướng dẫn chi tiết cách kiểm tra và cấu hình lại để Redis hoạt động ổn định trên mọi loại hosting, bao gồm: DirectAdmin, cPanel, Kusanagi, GenHosting,v.v.

2. Nguyên nhân thường gặp

Sai cấu hình kết nối Redis trong WordPress
- Plugin mặc định kết nối qua TCP (127.0.0.1:6379), trong khi hosting lại cấu hình Redis qua socket file (.sock).
- Điều này khiến WordPress không tìm thấy Redis dù server vẫn đang bật.
Chưa bật Redis Extension trong PHP
- Nếu module redis chưa được bật trong Select PHP Version (hoặc php.ini), plugin sẽ không thể giao tiếp được với Redis.
Redis chạy nhưng chưa cấp quyền socket hoặc database ID trùng
- Một số hệ thống chia Redis instance riêng cho từng user, cần chỉ định đúng socket path và database riêng để tránh xung đột.

3. Cách kiểm tra và khắc phục

🔹 Bước 1: Mở file cấu hình WordPress

Đăng nhập File Manager trên hosting.
Vào thư mục gốc website: public_html/
Tìm và chỉnh sửa file wp-config.php.

🔹 Bước 2: Sửa cấu hình Redis trong `wp-config.php`

Trường hợp 1 – Hosting dùng socket Redis (phổ biến nhất trên DirectAdmin, Kusanagi, GenHosting)

/* Redis configuration via UNIX socket */

define( 'WP_REDIS_SCHEME', 'unix' );

define( 'WP_REDIS_PATH', '/home/username/.redis/redis.sock' );

define( 'WP_REDIS_DATABASE', 0 );

define( 'WP_CACHE', true );

🔸 Lưu ý:

Thay username bằng tên user của hosting (xem trong đường dẫn home).
Xóa hoặc comment các dòng cũ nếu có:

// define( 'WP_REDIS_HOST', '127.0.0.1' );
// define( 'WP_REDIS_PORT', 6379 );

Trường hợp 2 – Hosting cho phép kết nối TCP (như cPanel, Cloud VPS, Kusanagi tự quản):

define( 'WP_REDIS_HOST', '127.0.0.1' );

define( 'WP_REDIS_PORT', 6379 );

define( 'WP_REDIS_DATABASE', 0 );

define( 'WP_CACHE', true );

Nếu Redis cài trên server khác, thay 127.0.0.1 bằng IP của Redis Server (ví dụ 10.0.1.5).

🔹 Bước 3: Kích hoạt lại plugin Redis Object Cache

Đăng nhập WordPress Admin → Cài đặt → Redis Object Cache
Nếu trước đó đang bật, chọn Disable → Enable để làm mới.
Khi kết nối thành công, giao diện sẽ hiển thị:

Status: Connected Filesystem: Writeable Redis: Reachable

4. Các lỗi phổ biến và cách xử lý nhanh

Thông báo lỗi	Nguyên nhân	Cách xử lý
`Redis is unreachable [tcp://127.0.0.1:6379]`	Redis chỉ chạy qua socket, không qua TCP	Chuyển cấu hình sang `WP_REDIS_SCHEME = unix`
`Redis extension not found`	PHP chưa bật module redis	Vào Select PHP Version → tick redis → Save
`Permission denied on redis.sock`	File socket không cấp quyền user	Kiểm tra permission quyền của file
`Object cache not enabled`	Chưa bật cache trong plugin	Nhấn Enable Object Cache
`Too many connections`	Redis giới hạn kết nối	reset Redis instance

5. Kết quả sau khi khắc phục

Redis kết nối thành công (trạng thái Reachable)
Plugin hoạt động ổn định
Website tải nhanh hơn, giảm thời gian truy vấn database

Bạn cũng có thể tham khảo thêm các dịch vụ Web Hosting, Cloud VPS, Server, Email Business do chúng tôi cung cấp hoặc xem các bài viết chia sẻ khác của chúng tôi tại đây

Liên hệ với chúng tôi qua: