稼働中の LiteSpeed Web Server において PHP のバージョンを 7.4 から 8.2 へアップグレードした直後、WordPress の高速化プラグインである LiteSpeed Cache の管理画面で、Memcached および Redis の接続テストが突如「Connection Test: Failed」と表示され、オブジェクトキャッシュが正常に機能しなくなるトラブルに見舞われました。
本稿では、この問題の原因を切り分け、Memcached（または Redis）の構成を再点検して接続エラーを解消するための具体的な手順を解説します。
問題の概要
WordPress 管理画面内の LiteSpeed Cache > オブジェクトキャッシュ（Object Cache） 設定ページにおいて、Memcached / Redis の接続テスト項目が赤字で「Connection Test: Failed」と表示される現象です。
これは一般に、サーバー内部で Memcached や Redis のデーモンが起動していないか、PHP 拡張モジュールが不足しているか、あるいはバインド設定やファイアウォールによってポートへのアクセスが遮断されている場合に発生します。
トラブルシューティングと解決手順
以下では、代表的なキャッシュデーモンである Memcached を Linux（Ubuntu / Debian 系、GCP Compute Engine 環境等）で稼働させるケースを例に解説します。
1. Memcached のインストール状況を確認
サーバー上に Memcached 本体および関連ライブラリがインストールされているか確認し、未導入の場合はインストールします：
sudo apt update
sudo apt install memcached libmemcached-tools※ PHP 8.2 環境で動作させる場合、対応する PHP 拡張（php8.2-memcached や lsphp82-memcached）が有効化されていることも併せて確認してください。
2. Memcached サービスの起動と自動起動の有効化
デーモンを手動で起動し、システム起動時に自動常駐するよう設定します：
sudo systemctl start memcached
sudo systemctl enable memcached3. サービス稼働ステータスの確認
サービスが正常にアクティブ（running）状態になっているか検証します：
sudo systemctl status memcached4. 設定ファイルの確認（バインドIPとポート）
設定ファイル /etc/memcached.conf を編集し、メモリ割り当て量およびリスンするIPアドレスを確認します。WordPress と同一サーバー（ローカルホスト）で運用する場合、安全のため -l パラメータが 127.0.0.1 に指定されていることを確認します：
-l 127.0.0.15. Memcached サービスの再起動
設定ファイルを更新した場合は、デーモンを再起動して設定を反映させます：
sudo systemctl restart memcached6. リスンポートの疎通確認
Memcached の標準ポートである 11211 番ポートで正しく待受が行われているか確認します：
sudo netstat -tuln | grep 11211出力結果に 127.0.0.1:11211 LISTEN が表示されていれば正常です。
7. LiteSpeed Cache プラグイン側の設定確認
WordPress 管理画面の LiteSpeed Cache > Cache > Object 画面を開き、以下のパラメータを照合します：
- オブジェクトキャッシュ：ON
- メソッド：Memcached
- ホスト：
127.0.0.1（またはlocalhost） - ポート：
11211
8. 接続テストの再試行
設定を保存後、接続ステータスを再読み込みします。正常に疎通が確認できれば、表示が緑色の「Connection Test: Passed」に切り替わります。
接続失敗を引き起こす主な要因
接続テストが Failed となる場合、以下の4つのポイントを疑うのが鉄則です：
- デーモンの未起動またはクラッシュ：PHP のメジャーアップデート時にキャッシュパッケージの依存関係が外れ、サービスが停止している。
- バインドアドレスの不一致：
-lの設定が外部ネットワークや意図しないインターフェースに向いている。 - ポート競合またはファイアウォール遮断：UFW やクラウド側のセキュリティグループで内部通信がブロックされている。
- PHP 拡張モジュールの欠落：LiteSpeed 独自の LSPHP 環境（例：
lsphp82）に対応する Memcached / Redis 拡張モジュールがインストールされていない。
上記の手順に沿って一つずつ設定を検証していけば、安全かつ確実に「Connection Test: Passed」の状態を取り戻し、WordPress の爆速レスポンスを維持することができます。
独自の視点と客観的な報道を、あなたの温かい支援で
表面的なトレンドやアルゴリズムに流されず、事実と深い洞察に基づいた独立した記事をお届けし続けるために。
質の高いオリジナル記事と独立した運営を続けるため、1回のみ、または毎月のご支援をGoogleの安全な決済でお願いいたします。
お支払いはGoogleにより安全に処理されます · いつでも管理・解約できます
コメント