MySQL で「Can't connect to MySQL server」(2002/2003) で接続できない
Can't connect to MySQL server は、mysqld を起動し、ソケットやポートの指定を直せば接続できる。
2002 は Unix ソケット、2003 は TCP の接続失敗である。
公開: 更新:
mysql -u root -h localhost -e "SELECT 1" ERROR 2002 (HY000): Can't connect to local MySQL server through socket '/var/run/mysqld/mysqld.sock' (2)
mysql -u root -h 127.0.0.1 -P 3306 -t -e "SELECT @@port, CURRENT_USER()" +--------+----------------+ | @@port | CURRENT_USER() | +--------+----------------+ | 3306 | root@127.0.0.1 | +--------+----------------+
2026-10-09 に mysql:8.4(MySQL 8.4.11) で実際に打って取った出力。検証環境の詳細
要約
ERROR 2002 (HY000): Can't connect to local MySQL server through socket や ERROR 2003 (HY000): Can't connect to MySQL server on 'host' は、クライアントが MySQL サーバーに到達できないときに出る。
2002 は Unix ソケット経由、2003 は TCP 経由の接続が失敗したことを示す。
括弧内の 10061(Windows)や 111(Linux)は、OS 側のエラー番号である。
切り分けは、mysqld が起動しているかの確認から始める。
実行例
mysql:8.4 で試すと、-h localhost はクライアントが既定で見に行くソケットパスを使い、2002 になった。
サーバーが実際に使っているソケットを指定すると、同じサーバーに接続できた。-h 127.0.0.1 に切り替えると TCP 経由になり、ソケットパスの食い違いとは無関係に繋がった。
$ mysql -u root -h localhost -e "SELECT 1"
ERROR 2002 (HY000): Can't connect to local MySQL server through socket '/var/run/mysqld/mysqld.sock' (2)
$ echo $?
1$ mysqladmin -u root --socket=/tmp/tmp.kFEVXUEu0t/mysqld-custom.sock ping
mysqld is alive
$ echo $?
0$ mysql -u root --socket=/tmp/tmp.kFEVXUEu0t/mysqld-custom.sock -t -e 'SELECT @@socket'
+----------------------------------------+
| @@socket |
+----------------------------------------+
| /tmp/tmp.kFEVXUEu0t/mysqld-custom.sock |
+----------------------------------------+
$ echo $?
0$ mysql -u root -h 127.0.0.1 -P 3306 -t -e "SELECT @@port, CURRENT_USER()"
+--------+----------------+
| @@port | CURRENT_USER() |
+--------+----------------+
| 3306 | root@127.0.0.1 |
+--------+----------------+
$ echo $?
0— 2026-10-09 時点の出力
検証環境MySQL 8.4.11 / 2026-10-09 検証
- 検証日
- 実行環境
mysql:8.4Oracle Linux Server 9.8- バージョン
- MySQL 8.4.11
この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。
解決策
1. サーバーの起動を確認する
mysqladmin -u root -p ping
sudo systemctl status mysql停止していれば起動する。
まずここを確かめる。
2. localhost と 127.0.0.1 を使い分ける
mysql -h 127.0.0.1 -P 3306 -u root -plocalhost は Unix ソケットを、127.0.0.1 は TCP を使う。
ソケット由来の問題は 127.0.0.1 で回避できる。
3. ソケット/ポートを明示する
mysql --socket=/var/run/mysqld/mysqld.sock -u root -p設定ファイルの socket / port と一致するよう指定する。
4. リモート接続を許可する
my.cnf の bind-address を見直し、ファイアウォールで 3306 を開放する。
公開範囲は必要最小限にする。
よくある原因
- サーバーが起動していない。
mysqld が起きていないか、別ポートで待ち受けている。 - ソケットのパスが違う。
localhostは TCP ではなく Unix ソケットを使うため、パスがずれると 2002 になる。 - ポートが遮断されている。
3306 がファイアウォールで塞がれていると 2003 になる。 - bind-address で 127.0.0.1 だけを待ち受けていると、外部から繋がらない。