phpMyAdmin の localhost ログインが 2002 エラーで失敗する状況の対処

サマリ

/etc/phpmyadmin/config-db.php の $dbserver を 127.0.0.1 に変更する

-$dbserver='localhost';
+$dbserver='127.0.0.1';

環境

• Windows 10 + WSL2 (Ubuntu 20.04.2 LTS)
• mysql-server 8.0.31-0ubuntu0.20.04
• phpmyadmin 4:4.9.5+dfsg1-2

参考資料

インストール手順

トラブルシュートに役立ったリンク

https://gist.github.com/abobija/228e36441d31ae17ecc36edc9a47ceb5?permalink_comment_id=4246466#gistcomment-4246466
https://support.ntt.com/mw-businessr3/faq/detail/pid2300001k7e/

反省

• エラーメッセージで原因を詳細に特定すること大切。勝手に PW の問題と決めつけて進めてしまったが、エラーメッセージは mysql の設定自体の問題を指していた。
• また、リカバリの過程でパッケージのクリーンナップがうまくいかない問題も再起動で直るようなものなのに試せていなかった。
• トラブルシューティングの基本。