💡 ULASAN & REFERENSI • DIPERBARUI: 25 October 2026 • REDAKSI AZWINN

Cara Mengatasi Error Redis Object Cache pada WordPress

Error Redis Object Cache pada WordPress umumnya disebabkan oleh kegagalan koneksi soket, ekstensi PHP php-redis yang belum terinstal, atau kehabisan alokasi memori di server. Masalah ini membuat situs gagal terhubung ke layanan caching dan sering kali memicu kesalahan Establishing a Database Connection jika tidak segera ditangani.

Untuk mengatasi masalah ini secara cepat dan tepat sasaran, identifikasi terlebih dahulu jenis error yang muncul melalui file log server atau layar administrator WordPress Anda, lalu terapkan langkah perbaikan teknis di bawah ini.

Tabel Diagnostik Error Redis dan Solusi Cepat

Gejala / Pesan Error Akar Penyebab Solusi Utama
Connection refused atau Error establishing socket Layanan Redis tidak berjalan atau salah konfigurasi port/socket. Restart layanan Redis dan cek file wp-config.php.
Class 'Redis' not found Ekstensi PHP untuk Redis belum terinstal di server. Install ekstensi php-redis via SSH.
OOM command not allowed when used memory > 'maxmemory' Kapasitas RAM Redis penuh dan kebijakan memori salah. Ubah parameter maxmemory-policy di redis.conf.

Langkah-Langkah Perbaikan Teknis

1. Memastikan Layanan Redis Berjalan

Jika situs tiba-tiba mengalami kendala koneksi, pastikan daemon Redis aktif di server Linux Anda. Jalankan perintah berikut melalui SSH:

sudo systemctl status redis
sudo systemctl restart redis

Jika layanan gagal dimulai, periksa file log error Redis yang biasanya terletak di /var/log/redis/redis-server.log.

2. Mengonfigurasi wp-config.php dengan Benar

Pastikan parameter host dan port sudah sesuai dengan lingkungan server Anda. Tambahkan atau sesuaikan baris berikut di dalam file wp-config.php:

define( 'WP_REDIS_HOST', '127.0.0.1' );
define( 'WP_REDIS_PORT', 6379 );
// Jika menggunakan password
define( 'WP_REDIS_PASSWORD', 'password_anda_disini' );
// Menentukan database index jika sharing server
define( 'WP_REDIS_DATABASE', 0 );

3. Mengatasi Masalah Memori Penuh (OOM Error)

Ketika Redis mencapai batas maksimal memori, operasi penulisan data akan ditolak. Buka file konfigurasi Redis (/etc/redis/redis.conf) menggunakan teks editor seperti nano:

sudo nano /etc/redis/redis.conf

Cari baris maxmemory dan maxmemory-policy, kemudian ubah nilainya menjadi:

maxmemory 256mb
maxmemory-policy allkeys-lru

Simpan perubahan dan restart kembali layanan Redis agar konfigurasi diterapkan.

4. Membersihkan Cache yang Korup

Terkadang data cache yang tertinggal menyebabkan konflik setelah pembaruan plugin. Anda dapat membersihkan seluruh cache Redis secara manual melalui CLI:

redis-cli flushall

Atau jika menggunakan WP-CLI di direktori instalasi WordPress:

wp redis flush

Tips Pemeliharaan Rutin

Lakukan pemantauan secara berkala pada penggunaan memori Redis menggunakan perintah redis-cli info memory untuk memastikan alokasi RAM mencukupi beban trafik situs Anda. Selalu perbarui plugin Redis Object Cache ke versi terbaru guna menghindari celah keamanan dan inkonsistensi fungsi.

🔍 Orang Lain Juga Mencari Ini