// MySQL エラーリファレンス

MySQL エラー 2002: ソケット経由で接続できません

クライアントはローカルの Unix ソケットを試しましたが、そこにサーバーは見つかりませんでした。サーバーが起動していないか、別のソケットパスを使っているか、TCP 接続を意図していたかのいずれかです。

エラー番号
2002
名前
CR_CONNECTION_ERROR
カテゴリ
接続とクライアント
エラーメッセージ
Can't connect to local MySQL server through socket '%s' (%d)

意味

接続先が localhost Unix では、MySQL クライアントは TCP ではなく Unix ソケットファイルを使用します。2002 は、ソケットファイルが存在しないか、何も待ち受けていないことを意味します。角括弧内の数字は OS のエラー番号で、たとえば (2) そのようなファイルがない場合、および (111) 接続拒否の場合。

クライアント側のエラーです。リクエストはサーバーに到達していません。

よくある原因

  • MySQL サーバーが起動していないか、起動時にクラッシュしました。
  • サーバーのソケットが、クライアントの想定とは別の場所にあります(例えば /var/run/mysqld/mysqld.sock 対 /tmp/mysql.sock).
  • サーバーが Docker 内または別のマシンで動いているため、ローカルソケットはありません。TCP が必要です。
  • ソケットディレクトリの権限によっては、クライアントがそこへ到達できません。

修正方法

  1. サーバーが実行中であることを確認し、実行中でなければエラーログを読みます。例えば systemctl status mysql Linux または brew services list macOS で。

  2. 次を使って、ソケットの代わりに TCP で接続します 127.0.0.1 ではなく localhost、または --protocol=TCP.

    mysql -h 127.0.0.1 -P 3306 -u app -p
  3. サーバーがローカルで動作している場合は、そのソケットパスを調べて、クライアントがそれを指すようにしてください。

    -- On the server:
    SHOW VARIABLES LIKE 'socket';
    -- Client:
    mysql --socket=/var/run/mysqld/mysqld.sock -u app -p

関連エラー

その他の接続とクライアントのエラー

コードとメッセージのテキストは、 MySQL 8.4 エラーメッセージ参照。全容は次で参照 MySQL エラー一覧 または すべてのデータベースエラーを検索.

// エラーが減り、修正も速く

SQLly で MySQL を操作する

macOS、Windows、Linux 用のネイティブ SQL クライアント。スキーマを認識する IntelliSense、危険なステートメントへのガードレール、分かりやすいエラーメッセージを備え、MySQL をはじめ、お使いの他のデータベースにも対応します。