Sitenizde nesne önbelleği için Redis kullanıyorsunuz ve bir gün panelde ya da site sağlığı ekranında ‘Redis bağlantısı kurulamadı’ yazısı beliriyor. Site çalışmaya devam edebilir ama her istekte veritabanına gittiği için yavaşlar, bazen de panel tökezler. Bu hata, WordPress’in hızlandırıcı olarak kullandığı Redis servisine ulaşamadığını söyler.
Redis, sık kullanılan veritabanı sorgularının sonucunu bellekte tutarak siteyi hızlandıran bir servistir. WordPress bu servise bir eklenti aracılığıyla bağlanır. Bağlantı koptuğunda hata ortaya çıkar. İyi haber şu: altında yatan sebepler sınırlı ve çoğu birkaç kontrolle bulunur.
Neden bağlanamıyor
- Redis servisi çalışmıyor. Sunucu yeniden başlamış ve servis otomatik açılmamış olabilir, ya da servis çökmüş olabilir.
- Bağlantı ayarları yanlış. Eklentinin kullandığı adres, port ya da şifre, Redis’in gerçekte dinlediği değerlerle uyuşmuyor olabilir.
- Şifre uyuşmazlığı. Redis bir parola istiyorsa ve eklentide bu parola tanımlı değilse bağlantı reddedilir.
- Eklenti yapılandırması bozulmuş. Nesne önbelleği dosyası eski ayarlara işaret ediyor olabilir.
Adım adım çözüm
- Önce Redis servisinin çalışıp çalışmadığını kontrol edin. Sunucuya erişiminiz varsa servisin durumuna bakın ve kapalıysa başlatın. Paylaşımlı hostingde servisi siz yönetemezsiniz, bu durumda durumu hosting firmanıza iletin. Çoğu kesinti, yeniden başlatılmış ama tekrar açılmamış bir servisten kaynaklanır.
- Bağlantı ayarlarını doğrulayın. Redis’in dinlediği adres genelde yerel sunucu, port ise standart olarak 6379’dur. wp-config.php içinde ya da önbellek eklentisinin ayarlarında tanımlı adres, port ve şifrenin bunlarla aynı olduğundan emin olun. Bir port ya da adres değişikliği yapıldıysa eklentinin haberi olmayabilir.
- Şifreyi kontrol edin. Redis parola ile korunuyorsa aynı parolanın eklenti ayarında da tanımlı olması gerekir. Parola sunucu tarafında değiştirildiyse eklentideki değeri güncelleyin.
- Nesne önbelleği dosyasını geçici olarak kaldırın. WordPress Redis’i kullanırken wp-content klasörüne object-cache.php adında bir bağlantı dosyası koyar. Bu dosya bozulduysa ya da eski ayarları tutuyorsa hata üretir. Dosyayı geçici olarak silin ya da yeniden adlandırın. WordPress o anda normal önbelleğe düşer ve site çalışmaya devam eder. Ardından önbellek eklentisinden Redis bağlantısını yeniden etkinleştirin, eklenti dosyayı güncel ayarlarla yeniden oluşturur.
- Hâlâ bağlanmıyorsa hosting desteğine yazın. Redis’in sunucu tarafındaki yapılandırması, bellek sınırı ya da erişim izinleri sizin görmediğiniz bir noktada engelliyor olabilir. Hata metnini ve denediklerinizi iletirseniz destek süreci hızlanır.
Bağlantının kopmasının bir başka sebebi Redis’in bellek sınırına dayanmasıdır. Redis belleğe sığmayan verilerle dolduğunda yapılandırmasına göre ya eski kayıtları atar ya da yeni yazma isteklerini reddeder. Reddetme durumunda WordPress bağlantı hatası görür. Sunucuyu yönetiyorsanız Redis’in bellek sınırını ve dolduğunda ne yapacağını belirleyen ayarı gözden geçirin. Paylaşımlı bir ortamdaysanız bu sınır hosting tarafından belirlenir.
Birden fazla sitenin aynı Redis sunucusunu paylaştığı kurulumlarda, sitelerin ayrı veritabanı numaraları ya da anahtar önekleri kullanması gerekir. Aksi halde siteler birbirinin önbelleğine karışır ve beklenmedik hatalar çıkar. Eklentinin ayarlarında her site için farklı bir önek tanımlamak bu karışıklığı önler ve hangi verinin hangi siteye ait olduğunu belirgin tutar.
Tekrar yaşamamak için
Redis servisinin sunucu açılışında otomatik başlayacak biçimde ayarlı olduğundan emin olun, böylece bir yeniden başlatma siteyi önbelleksiz bırakmaz. Bağlantı ayarlarını bir yere not edin, port ya da parola değiştiğinde eklentiyi güncellemeyi unutmayın. Site sağlığı ekranını ara ara kontrol etmek, önbelleğin gerçekten devrede olduğunu görmenizi sağlar. Nesne önbelleği dosyasını elle düzenlemekten kaçının, bırakın eklenti onu kendisi yönetsin.
Redis hatası ilk görüldüğünde ürkütücü olabilir, ama site hata sırasında bile ayakta kalır ve çözüm genelde servisi başlatmak ya da ayarları eşlemekle biter. Hangi ortamda çalıştığınızı söylerseniz adımları sunucunuza göre birlikte sadeleştirebiliriz.
Bu işleri kendiniz yapmak yerine profesyonel destek isterseniz, WordPress bakım ve teknik destek hizmetime göz atabilirsiniz.
Bu konunun tüm rehberi: WordPress Hataları ve Çözümleri