初步評估

Failed to initialize object cache: The `WP_REDIS_CONFIG` constant has not been defined.

WordPress 出現「Failed to initialize object cache: The WP_REDIS_CONFIG constant has not been defined.」:原因與檢查方式

更新 2026-11-01
# 錯誤紀錄中常見的內容
objectcache.critical: Failed to initialize object cache: The `WP_REDIS_CONFIG` constant has not been defined.

Object Cache Pro 的 drop-in 檔 wp-content/object-cache.php 還在,wp-config.php 卻沒有定義 WP_REDIS_CONFIG 時,會顯示這句訊息。搬家後很常見:drop-in 跟著 wp-content 一起搬過去,新主機的 wp-config.php 卻沒有 Redis 的設定。

你現在看到的是哪一種情況?

新主機的 wp-config.php 沒有 WP_REDIS_CONFIG 這段設定,舊網站的 wp-content/object-cache.php 卻還在。

刪除外掛不會刪掉 drop-in 檔,而 WordPress 每次請求都會載入那個檔案。

常見原因

缺少設定常數:wp-config.php 被換掉或重寫,少了 WP_REDIS_CONFIG 這一段。
殘留的 drop-in:外掛移除後,object-cache.php 仍留在 wp-content。
新伺服器沒有 Redis:設定還在,新伺服器卻沒有可以連線的 Redis。

參考資料

  1. WP_Object_Cache (WordPress Developer Resources)
  2. Cache (Advanced Administration Handbook)

不想自己動手處理?WP119 全自動修復

快取殘留檔與物件快取失聯造成的錯誤屬於自動處理的項目:系統移除卡死的快取檔;快取後端失聯時,移除殘留設定。修復在維修站的網站副本上進行,複驗通過後才寫回。您網站資料庫裡的受保護資料表(會員、留言、訂單、表單填寫)只取結構。SSH/FTP 模式下,系統寫回前先在您的主機建立修復前備份,寫回後驗證沒通過時,以這份備份進行還原。修復未能完成,修復費全額退還。

  1. 初步評估:輸入網址
  2. 複製到維修站:在副本上作業
  3. 找出原因:逐項檢查
  4. 修復與複驗:首頁與內頁
  5. 寫回或交付:複驗通過才進行

這句訊息讓網站或管理後台打不開時,可以交給 WP119。

初步評估我的網站 →
初步評估 →