XAMPPでデータベース接続確立エラーが突然出た...XAMPPの再インストールとデータベースの修復方法。

XAMPPでデータベース接続確立エラーが出た時の対処法

XAMPPでデータベース接続確立エラーが出た時の状況は以下です。

これから紹介する内容は環境によっては上手くいかないかもしれません。
なので、１度目を通してから必要な箇所を試していただければと思います。

エラーの状況と試したこと

先日いつものようにXAMPPを立ち上げ、WordPressの管理画面にログインしようとしたところデータベース接続確立エラーが出ました。

XAMPPでのデータベース接続確立エラー画面

ずら～とWarningが出ており、wp-db.phpでエラーが発生している様子です。

エラー説明を日本語訳してみると、

MySQL server has gone away：MySQLサーバーがなくなりました

とあります。

念のためwp-config.phpを確認してみるもユーザー名もパスワードも正しく記述されています。そもそもXAMPP内のファイルは一切編集していないので、変わっているはずもありません。

ここから以下のようなことを色々試したのですが一向に解決できません。

MySQLが起動できない

そしてついにXAMPPのMySQLが起動しなくなりました…
Startを押すと以下のエラーがでます。

【原文】
MySQL shutdown unexpectedly.
This may be due to a blocked port, missing dependencies,
improper privileges, a crash, or a shutdown by another method.
Press the Logs button to view error logs and check
the Windows Event Viewer for more clues
If you need more help, copy and post this
entire log window on the forums

Startを押すとすぐに停止してしまいます。
調べたところデータベースの破損の可能性が高いとのこと...

で、今回考えられる原因は

この２つくらいです。

そういえば以前のPCにもXAMPPをインストールしており、突如このエラーでMySQLが起動できなくなったのでWindowsアップデートが原因の可能性が高いのかも...

解決しようとしたのですが、エラーの内容が曖昧すぎて良く分かりません。
後日調べて「Error: MySQL shutdown unexpectedly.」のエラーを解決しました。

MySQLのエラーを解決し、起動する方法は別記事（↑）に書いています。

MySQLの修復は上手くいったのですが、それでも「データベース接続確立エラー」が出てダメ...ということで思い切ってXAMPPを再インストールして解決しました！
というのが当記事の内容です。

XAMPPのバックアップに必要なファイル

XAMPPをアンインストールしてしまうと、その時点でインストールしたフォルダ内の全てのファイルが削除されてしまうので、バックアップを取る作業がまず必要です。

バックアップに必要なファイルは数種類ですが、アンインストール後は取り返しがつかないので、「xampp」フォルダを丸ごとをバックアップとしてどこかにコピーしておくと安心です。

xamppフォルダ丸ごとをバックアップとして残す

インストール時に変更していなければ、XAMPPがインストールされるのは「xampp」という名前のフォルダです。これをどこかにコピーしておきましょう。

XAMPPフォルダ内の以下のファイルが特に重要です。

「htdocs」や「mysql」などの自分で編集したオリジナルのファイルが含まれるものさえバックアップしておけば最悪何とかなります。

今回使用するのはこの３ファイル

今回使用したのは「htdocs」「mysql」「phpMyAdmin」の３ファイルだけですが、後々必要になる可能性もあるのでやはり「xampp」フォルダ丸ごとをコピーするのがオススメです。

XAMPPの再インストール

バックアップを取ったらあとはパソコンからアンインストールするだけです。

xampp内のuninstall.exeでアンインストールができる

xamppフォルダ内のuninstall.exeを実行すればアンインストールが可能です。
もちろんパソコンのプログラム一覧からアンインストールしてもOK！

アンインストールの確認

Do you want to uninstall XAMPP and all of its modules?

XAMPPとそのすべてのモジュールをアンインストールしますか？
と聞かれます。ここでYesを押すとアンインストールが実行されます。
この先で✕を押しても止められませんのでバックアップを最終確認しましょう。

htdocsフォルダを削除するかの確認

htdocsフォルダも削除しますか？と聞かれます。
XAMPPのインストールフォルダは空でないとダメなので、消します。

アンインストールが終了したら、xamppフォルダ内に何かフォルダが残っていないか確認しましょう。僕の場合はなぜかphpMyAdminフォルダが残っていました。

あとはXAMPPのインストーラーをダウンロードして実行すればOK！

再インストール後MySQLが無事に起動した

XAMPPを再インストールしたところMySQLが無事に起動するようになりました。

続いて、バックアップからデータとデータベースの復旧作業を行います。

XAMPPデータベースの復旧作業

ここからは、先ほどバックアップとしてコピーしておいた「xampp」フォルダ内から新しくインストールしたXAMPPのインストールフォルダ「xampp」に必要なファイルを上書き保存していきます。

同名のファイル名でややこしい方はバックアップしたフォルダを別の名前にしておきましょう。

インストールした新xamppフォルダに上書き保存

「htdocs」と「phpMyAdmin」をインストールしたxampp内に上書き保存します。

この状態でxamppを起動してWordpressのログイン画面にアクセスしてみます。

別のデータベース接続確立エラーが発生

別のエラーが発生しました。

Access denied for user 'root'@'localhost' (using password:YES)

ユーザー 'root' @ 'localhost'のアクセスが拒否されました（パスワードを使用）

XAMPPのデータベースにパスワードを設定している場合、何らかの理由でこれが変更？されているみたいです。
phpMyAdminにも以前のパスワードでログインできません。

そこで以前まで使用していたパスワードを再設定します。
（wp-config.php内で確認可）

データベースパスワードの再設定

データベースパスワードの設定はXAMPPのコントロール画面にあるShellからコマンドベースで行います。

データベースパスワードの再設定

XAMPPでApacheとMySQLをstartで起動した後、コマンドを実行して下さい。
実行するコマンドは以下です。

新規設定コマンドでOKでした。

こちらも別の記事に詳しいやり方をまとめています。

phpMyAdminにログインできるようになった

パスワードを再設定すればようやくphpMyAdminにログインできるようになります。

パスワードを設定していなかった場合は分かりません…そのままログインできる？

データベースの復元

再度Wordpressのログイン画面にアクセスしてみます。

データベース選択不可のエラー

また別のエラーが出ました。

Unknown database 'データベース名'

不明なデータベース'データベース名'という内容です。

現時点で「htdocs」と「phpMyAdmin」だけを戻した状態でデータベースが存在しない状態となっているためこのエラーが出ます。

早速バックアップファイルからデータベースを戻しましょう。

xampp > mysql > data内にデータベースがある

XAMPPのデータベースの場所は以下です。

今回は「wpdb_01」という名前のファイルが以前からWordpressで使用していたデータベース名です。

このデータベース（僕はwpdb_01）をインストールしたxampp内のmysql＞data内にコピーします。

Wordpressの再設定－失敗

データベースも元の場所に戻ったので再度Wordpressのログイン画面にアクセスしてみます。

Wordpressのようこその画面が出た

おお！これは成功しそうな感じ！
ユーザー名生きてるじゃん！

データベースエラーが発生して進めない

はい。そんな簡単にはいきません。
完全にデータベースが破損しているようです…

phpMyAdminにはデータベースの修復機能がありますのでこれを試してみます。

phpMyAdminでテーブルの修復を行う

やり方は以下でとても簡単です。

REPAIR TABLEというSQLコマンドを選択したテーブルに実行してくれます。
Wordpressにも同機能があるようです。

照合順序が使用中は破損の可能性が高い

phpMyAdminにログインしてデータベースを選択するとテーブルの一覧が出ます。
ここで照合順序が「使用中」となっていればデータベースが破損している可能性が高いらしいです。
正常な場合は「utf8mb4_unicode_ci」などと照合順が表示されます。

テーブルが使用中になっている

えー、全部のテーブルが使用中です。お亡くなりになっている可能性が高いです。
が、ダメもとでやってみましょう。

テーブルを修復するを選択

データベース内の全テーブルをチェックし...
「チェックしたものを：」とあるプルダウンをクリック。
プルダウンから「テーブルを修復する」を選びます。
画面右下の方にある実行をクリックでOK！

repair statusがOperation failedとなって失敗する

コマンド自体は実行されましたが、全テーブルリペアエラーとなりました。
これで治ったらラッキーですね…

データベースのバックアップがあるならphpMyAdminからインポートで治る可能性が高いです。

僕の場合所詮テスト環境と思いバックアップは取っていませんでしたので地獄ですw

データベースを作り直す

調べていたところテーブルの修復がコマンドで実行できない場合は、テーブルを同名で作り直すのが良いそうです。
データベースに詳しくない自分がゴリゴリやっても無駄なのは目に見えています。

１個づつ作ってられないので全削除→新規作成という力技を試します。

再度、下記のXAMPP内のデータベースまでアクセスします。

そして拡張子が「.frm」のFRMファイル。そして「.ibd」のIBDファイルを全削除します。

データベース内のdb.opt以外を全削除

念のためインストール時に作成される「db.opt」は残しました。

削除後はXAMPPのApacheとMySQLを再起動します。

そして再々再度くらい？ログイン画面にアクセス。

パスワードは以前と同じものに合わせる

すると先ほどとは少し違い、ユーザー名とパスワードの入力欄があります。
ユーザー名およびパスワードは以前使用していたものを入力しましょう。
そして進んでみる…

インストールに成功した

お！いけた。
ちなみにXAMPPを再起動していないと先ほどと同じようにエラー画面で止まります。

いつも通りログインしてみます。
これでダメなら１からまたサイト作った方が早いｗ

記事内容もCSSも復活した

はい！戻りました！
良く分からないのでかなりの力技でしたが無事にまたXAMPPでWordpressが使えるようになりました・ｗ・

ここで少し欲を出してデータベースをバックアップファイルから戻してみました。
（バックアップからxampp内にコピー）

テーマが使用しているデータベースやプラグインが使用しているデータベースでは変わらずデータベースエラーが発生してしまいました…
あくまで削除→新規作成という過程を踏まないと治らないようです。

そこでデータベースを削除してから、テーマやプラグインを再インストールしたり有効化してみたところうまく治りました。

まとめ

XAMPP内にインストールしたWordpressで突然データベース接続確立エラーが発生してしまった時の解決策をご紹介してみました。
もしもWindowsアップデートでXAMPPがデータベース接続エラーになったりMySQLが立ち上がらないようになるのであればなかなか難儀ですね…

あくまでも僕の環境で上手くいっただけであって上手くいかないかも…
バックアップを取っていなくてデータベースが破損してしまった場合の最終手段としてご検討いただけますと幸いです。

XAMPPでもデータベースのバックアップは大切です( ;∀;)