WordPressを手動復旧した記録|データベース接続確立エラーの原因と対処手順

サイトが突然、真っ白になった。

表示されたのは
「データベース接続確立エラー」。

写真も記事も、全部消えたように見える。
サーバーの向こう側で、世界が静止した。

WordPress を使っている限り、いつか必ず遭遇するタイプの事故らしい。
ただ、その「いつか」は、たいてい深夜に来る。

これは、その復旧の全記録。

同じ場所で止まった人のために、手順を残しておく。


症状

  • フロントページが表示されない
  • 管理画面(/wp-admin)にも入れない
  • 「Error establishing a database connection」

つまり
PHPは動いているが、DBに接続できていない状態。

原因はほぼこの3つ。

  • DB名の間違い
  • DBユーザー/パスワード不一致
  • サーバー側の停止

今回の犯人は、いちばん地味なやつだった。

DB名のタイポ。


原因

サーバー移行後、wp-config.php を手動編集した。

その時、
サーバー会社特有の 接頭辞(プレフィックス)付きDB名 を削ってしまった。

例:

正:xjfwppdl_wp123
誤:wp123

これだけで接続は完全に失敗する。

WordPressは容赦なく沈黙する。


実際にやった復旧手順

① DB名の確認

サーバー管理画面
→ データベース一覧を開く
→ 正式名称をコピー

「手入力しない」がコツ。コピペ一択。


② wp-config.php 編集

define('DB_NAME', '正しいDB名');
define('DB_USER', 'ユーザー名');
define('DB_PASSWORD', 'パスワード');
define('DB_HOST', 'localhost');

ここを完全一致させる。

全角スペースや余計な改行も敵。


③ アップロードして再読み込み

ブラウザ更新。

何事もなかった顔でトップページが表示された。

さっきまで死んでいたはずのサイトが、普通に呼吸している。

この瞬間がいちばん疲れる。


学んだこと

技術的には単純。

でも精神的ダメージは大きい。

写真はバックアップしているのに、
サイト自体のバックアップは曖昧だった。

順序が逆だと気づいた。

  • 作品
  • 記事
  • サイト基盤

全部同じ重さ。

これ以降、

  • DB自動バックアップ
  • wp-configの保存
  • 復旧手順のメモ化

この3つを習慣にした。


まとめ(同じ症状の人へ)

「データベース接続確立エラー」が出たら、まずここを見る。

  1. DB名(プレフィックス含む)
  2. ユーザー名
  3. パスワード
  4. サーバー停止の有無

9割は設定ミス。

落ち着いて確認すれば直る。

WordPressは壊れにくい。
人間が間違えるだけ。


余談

写真の現像も、サイトの復旧も似ている。

暗室で薬品の順番を間違えると像が出ないように、
設定が一文字違うだけで世界が表示されなくなる。

どちらも、ただの手順作業。

そして、どちらも少しだけ祈っている。

ちゃんと戻ってこい、と。

コメント