概要

Dockerを利用してローカルDBに接続するDjangoアプリケーションを起動後、DBeaver(データベース管理ツール)でローカルDBに接続したら以下のエラーが表示されました。

ERROR 1045 (28000): Access denied for user 'root'@'localhost'

本記事ではこちらの原因と解決方法を記載します。

解決方法

まずは結論から。
以下の箇所を変更することで、解決しました。

修正前

  mysql:
    image: mysql:latest
    container_name: xxxxx
    environment:
      MYSQL_ROOT_PASSWORD: xxxxx
      MYSQL_USER: root
      MYSQL_PASSWORD: xxxxx
      MYSQL_DATABASE: xxxxx
    ports:
      - "3306:3306"

上記の状態だとDBeaverの上述のエラーになります。
※ただし、上記でもDockerコンテナに入ってmysql -u root -pでアクセスすると問題なく接続できます

修正後

  mysql:
    image: mysql:latest
    container_name: xxxxx
    environment:
      MYSQL_ROOT_PASSWORD: xxxxx
      MYSQL_USER: xxxxx
      MYSQL_PASSWORD: xxxxx
      MYSQL_DATABASE: xxxxx
    ports:
      - "3310:3306" # MySQLコンテナを3310にマッピング

上記の通り、portsを変更することで、無事にDBeaverでローカルDBに入れました。

原因は...ポート番号の競合だった

原因はポート番号3306にありました。
なぜ3310に変更したら解決したのか？というと、3306ポートで競合が発生していたからです。
以下のコマンドで、3306が使われているのか確認できます。

sudo lsof -i :3306

lsofコマンドは"List Open Files"の略。
システム上で開かれているファイルやネットワークソケット、プロセスなどの情報をリストするためのコマンドです。これにより、ポート3306でリスンしているプロセスがわかります。

なにも返ってこない場合は3306ポートは使われていません。
しかし、自分の場合、以下のように返ってきました。

COMMAND  PID       USER   FD   TYPE             DEVICE SIZE/OFF NODE NAME
mysqld  1490 XXXXXXXXXX   20u  IPv4 XXXXXXXXXXXXXXXXXX      0t0  TCP localhost:mysql (LISTEN)

上記の出力結果から、プロセスmysqldによってポート3306が使用されていることが分かります。
つまり、ローカルマシン（ホストマシン）のMySQLサーバーがポート3306でリスンしているので、他のアプリケーションが同じポートを使用しようとすると競合が発生する、ということです。

3306のままでもDockerのmysqlコンテナに入ればアクセスできたのは、Docker上では、独自に確保したポートに接続しており、競合するポートがなかったからですね。
MySQLコンテナをポート3310にマッピングした場合、MySQLサーバーはポート3310でリスンし、MySQLクライアントはポート3310を使用して接続します。

新しいMySQLコンテナをDockerで起動する際、ポート番号を3306から変更する必要があったのです。上記では3310としましたが、3306以外であればOKです。これにより、複数のMySQLインスタンスを同じホストで実行できるようになります。

補足：`mysqld`ってなに？？

mysqldはMySQLデータベースサーバー（MySQLデーモン）の実行プロセスです。
デーモンとはUNIX系OSではバックグラウンドで動作するプロセスのことで、docker compose up -dのときのdと同じデーモンプロセスですね。

ちなみに以下コマンドで稼働しているかわかります。

$ mysqladmin ping -h 127.0.0.1
mysqld is alive