DB接続エラーはDB名・ユーザー・ホストを順番に見る
「データベース接続確立エラー」が出たら、最初に確認するのはDB名、DBユーザー、DBパスワード、DBホストの4つです。WordPress本体より、wp-config.phpの接続情報とサーバー側のDB情報が一致しているかを見ます。
特にサーバー移転、復元、DB名変更、パスワード変更の直後は、サイトファイルとDB設定の片方だけが古いまま残りやすいです。
- wp-config.phpのDB_NAME、DB_USER、DB_HOSTを確認する
- サーバー管理画面のDB名とユーザーを照合する
- DBパスワードを変更した履歴を確認する
- サーバー障害情報やメンテナンス情報を見る
wp-config.phpはWordPressの基本設定を持つ
WordPress公式のwp-config.php解説では、このファイルがデータベース接続情報などサイトの基本設定を持つ重要ファイルだと説明されています。編集する場合は、変更前の控えと復旧方法が必要です。
接続エラーでは、WordPressファイル、DBサーバー、認証情報のどこで不一致が起きたかを分けて確認します。
DB名とユーザー名、似ていて間違えそうです。
そこはよくある。
サーバー管理画面のDB一覧と並べて照合しよう。
パスワードを変えれば早いですか?
先に変更履歴を確認した方がいい。
何度も変えると組み合わせが分からなくなる。
DB接続エラーの確認順
エラー文だけでは原因は特定できません。接続情報の項目ごとに確認します。
| 確認項目 | 見る場所 | 起きやすいズレ |
|---|---|---|
| DB名 | wp-config.phpとサーバーDB一覧 | 移転先のDB名に変えていない |
| DBユーザー | DBユーザー管理 | ユーザー権限が不足 |
| DBパスワード | 変更履歴、管理画面 | 変更後にwp-config.phpへ反映していない |
| DBホスト | サーバー指定値 | localhostではない指定が必要 |
表示を戻すための切り分け
DB接続エラーは、値を推測して上書きせず、既存の正しい情報と照合します。
- 直前に移転、復元、パスワード変更をしたか確認する
- wp-config.phpを開く前にコピーを保存する
- サーバー管理画面でDB名とユーザーを確認する
- DBユーザーに対象DBの権限があるか確認する
- サーバー側障害やメンテナンスがないか見る
再インストールのボタンを押したくなりました。
それは最後。
記事が残っている可能性があるから、接続情報の確認が先だよ。
危なかったです。
まず控えます。
うん。
編集前のwp-config.phpを保存してから進めよう。
パスワードを推測して何度も変えない
焦ってDBパスワードを何度も変えると、正しい組み合わせがさらに分からなくなります。
- DB名とユーザー名を混同する
- localhost固定だと思い込む
- 移転元のDB情報を残したままにする
- パスワード変更履歴を残さない
よくある質問
WordPressを再インストールすれば直りますか?
通常は最初に行う対応ではありません。接続情報の不一致や権限を確認する方が安全です。
DB_HOSTはlocalhostでよいですか?
サーバーにより異なります。管理画面やサーバーの案内にあるDBホスト名を確認します。
記事データは消えていますか?
接続できないだけならDB内の記事は残っている可能性があります。復旧前に削除や再インストールを急がないでください。
データベース接続確立エラーが出たときに見る場所で状況別に判断するポイント
データベース接続確立エラーが出たときに見る場所では、同じ症状や確認作業でも、読者の状況によって先に見る場所が変わります。公開サイトが止まっている時、設定前に不安を減らしたい時、すでに一度変更してしまった時を分けると、余計な操作を減らせます。
| 読者の状況 | 先に見ること | 後回しにすること |
|---|---|---|
| これからデータベース接続確立エラーが出たときに見る場所を確認する | wp-config.phpのDB_NAME、DB_USER、DB_HOSTを確認する | 別テーマの設定変更 |
| すでに問題が起きている | 直前に移転、復元、パスワード変更をしたか確認する | 見た目だけの調整 |
| 原因が分からない | wp-config.phpとサーバーDB一覧 | 複数設定の同時変更 |
| 再発を防ぎたい | DB名とユーザー名を混同する | 作業メモなしの再実行 |
作業後に残すメモ
データベース接続確立エラーが出たときに見る場所を確認した後は、作業した日時、変更した項目、確認したURL、戻し方を短く残します。メモは長い文章でなくて構いません。次に同じ画面を開いた時に、何を見て何を変えたのか分かることが目的です。
- 確認した項目: wp-config.phpのDB_NAME、DB_USER、DB_HOSTを確認する、サーバー管理画面のDB名とユーザーを照合する、DBパスワードを変更した履歴を確認する
- 実行した作業: 直前に移転、復元、パスワード変更をしたか確認する、wp-config.phpを開く前にコピーを保存する
- 避けること: DB名とユーザー名を混同する、localhost固定だと思い込む
- 公開URL、管理画面、メールやフォームなど読者接点の確認結果
- 次回見直す日付または条件
このメモがあると、別の人に相談する時も状況を説明しやすくなります。WordPressやサーバー設定のトラブルは、正しい答えそのものより「何をした直後に変わったか」が復旧の手がかりになります。
DB情報は正しい組み合わせで控える
DB名、ユーザー、ホスト、権限を1セットで確認してください。1項目だけ変えるより、不一致の場所を特定することが復旧を早くします。
DB名、ユーザー、ホストを照合します。
その3つでかなり絞れる。
記事が消えたと決めつけずに確認します。
落ち着いて見れば戻せる可能性が高いよ。